IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients Version 7.1.2 Installation and User's Guide
IBM Tivoli Storage Manager for UNIX and LinuxBackup-Archive ClientsVersion 7.1.2
Installation and User's Guide
���
IBM Tivoli Storage Manager for UNIX and LinuxBackup-Archive ClientsVersion 7.1.2
Installation and User's Guide
���
Note:Before you use this information and the product it supports, read the information in “Notices” on page 701.
Third edition (April 2015)
This edition applies to version 7, release 1, modification 2 of IBM Tivoli Storage Manager (product numbers5608-E01, 5608-E02, and 5608-E03) and to all subsequent releases and modifications until otherwise indicated in neweditions.
© Copyright IBM Corporation 1993, 2015.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
Contents
Tables . . . . . . . . . . . . . . . xi
About this publication . . . . . . . . xiiiWho should read this publication. . . . . . . xiiiPublications . . . . . . . . . . . . . . xiiiConventions used in this publication . . . . . xivReading syntax diagrams . . . . . . . . . xiv
New for IBM Tivoli Storage ManagerVersion 7.1.2. . . . . . . . . . . . xvii
Chapter 1. Installing the Tivoli StorageManager backup-archive clients . . . . 1Upgrading the backup-archive client . . . . . . 1
Upgrade path for clients and servers . . . . . 1Additional upgrade information . . . . . . . 1Automatic backup-archive client deployment . . 2
Client environment requirements . . . . . . . 4AIX client environment . . . . . . . . . . 4
AIX client installable components . . . . . 5System requirements for the AIX client . . . 5AIX client communication methods . . . . . 5Backup-archive client features that are availableon AIX . . . . . . . . . . . . . . 5
HP-UX Itanium 2 client environment . . . . . 6HP-UX Itanium 2 client installable components 6System requirements for HP-UX Itanium 2clients . . . . . . . . . . . . . . 6HP-UX Itanium 2 client communicationmethods . . . . . . . . . . . . . . 6
Linux on POWER client environment . . . . . 6Linux on POWER client installable components 6System requirements for Linux on Powerclients . . . . . . . . . . . . . . 7Linux on Power Systems client communicationmethods . . . . . . . . . . . . . . 7
Linux x86_64 client environment. . . . . . . 7Linux x86_64 client installable components . . 7System requirements for Linux x86_64 clients . 7Linux x86_64 client communication methods . 8
Linux on System z client environment . . . . . 8Linux on System z client installablecomponents. . . . . . . . . . . . . 8System requirements for Linux on System zclients . . . . . . . . . . . . . . 8Linux on System z client communicationmethods . . . . . . . . . . . . . . 8
Mac OS X client environment . . . . . . . . 9Mac OS X client installable components . . . 9System requirements for Mac OS X clients . . 9Mac OS X client communication methods. . . 9
Oracle Solaris client environment . . . . . . 10Oracle Solaris client installable components. . 10System requirements for Oracle Solaris clients 10
Oracle Solaris client communication methods 10NDMP support requirements (Extended Editiononly) . . . . . . . . . . . . . . . . 10Installation requirements for backing up andarchiving Tivoli Storage Manager FastBack clientdata . . . . . . . . . . . . . . . . . 11Installing from the Tivoli Storage Manager DVDs. . 11Install the UNIX and Linux backup-archive clients 12
Installing the Tivoli Storage Manager AIX client 12Uninstalling the Tivoli Storage Manager AIXclient . . . . . . . . . . . . . . . 16Installing the Tivoli Storage Manager HP-UXItanium 2 client . . . . . . . . . . . . 16
Increasing the default limit of the datasegment size . . . . . . . . . . . . 18
Uninstalling the Tivoli Storage Manager HP-UXItanium 2 client . . . . . . . . . . . . 18Installing the Tivoli Storage Managerbackup-archive client on Linux on PowerSystems . . . . . . . . . . . . . . 19Uninstalling the Tivoli Storage Manager Linux onPower client . . . . . . . . . . . . . 22Installing the Tivoli Storage Manager Linuxx86_64 client . . . . . . . . . . . . . 23Uninstalling the Tivoli Storage Manager Linuxx86_64 client . . . . . . . . . . . . . 27Installing the Tivoli Storage Manager UbuntuLinux x86_64 client . . . . . . . . . . . 28Uninstalling the Tivoli Storage Manager UbuntuLinux x86_64 client . . . . . . . . . . . 31Installing the Tivoli Storage Manager Linux onSystem z client . . . . . . . . . . . . 32Uninstalling the Tivoli Storage Manager Linux onSystem z client . . . . . . . . . . . . 35Installing the Tivoli Storage Manager Mac OS Xclient . . . . . . . . . . . . . . . 36Uninstalling the Tivoli Storage Manager Mac OSX client . . . . . . . . . . . . . . . 37Installing the Tivoli Storage Manager Solarisclient . . . . . . . . . . . . . . . 38Uninstalling the Tivoli Storage Manager Solarisclient . . . . . . . . . . . . . . . 42Software updates . . . . . . . . . . . 42
Chapter 2. Configure the Tivoli StorageManager client . . . . . . . . . . . 43UNIX and Linux client root and authorized usertasks. . . . . . . . . . . . . . . . . 43Enable non-administrators to manage their owndata . . . . . . . . . . . . . . . . . 45
Restricting Tivoli Storage Manager access to auser group. . . . . . . . . . . . . . 45Enabling encryption for Tivoli Storage Managerclient users . . . . . . . . . . . . . 46
© Copyright IBM Corp. 1993, 2015 iii
|||
||||||
|||
Creating and modifying the client system-optionsfile . . . . . . . . . . . . . . . . . 47Creating a default client user-options file . . . . 49Creating a customized client user-options file . . . 50Setting options in the client options file . . . . . 50Environment variables. . . . . . . . . . . 52
Set language environment variables . . . . . 52Set processing environment variables . . . . . 53Set Bourne and Korn shell variables . . . . . 55Set C shell variables . . . . . . . . . . 55Set API environment variables . . . . . . . 55
Configuring the web client . . . . . . . . . 55Configuring the scheduler . . . . . . . . . 57
Comparison between client acceptor-managedservices and traditional scheduler services . . . 57Configuring the client to use the client acceptorservice to manage the scheduler . . . . . . 58
Start the client scheduler . . . . . . . . . . 59Scheduling events using the command-line client 59
Configuring Tivoli Storage Manager client/servercommunication across a firewall . . . . . . . 61Configuring Tivoli Storage Manager client/servercommunication with Secure Sockets Layer . . . . 63
Certificate Authorities root certificates . . . . 66Configure your system for journal-based backup . . 67
Journal daemon configuration . . . . . . . 67JournalSettings stanza . . . . . . . . . 68JournalExcludeList stanza . . . . . . . 69JournaledFileSystemSettings stanza . . . . 70Overriding stanzas . . . . . . . . . . 72
Client-side data deduplication . . . . . . . . 73Configuring the client for data deduplication . . 77Excluding files from data deduplication . . . . 79
Automated client failover configuration and use . . 80Automated client failover overview . . . . . 80
Requirements for automated client failover . . 81Restrictions for automated client failover . . 81Failover capabilities of Tivoli Storage Managercomponents . . . . . . . . . . . . 83
Configuring the client for automated failover . . 83Determining the status of replicated client data 85Preventing automated client failover . . . . . 85Forcing the client to fail over . . . . . . . 86
Configuring the client to back up and archive TivoliStorage Manager FastBack data . . . . . . . . 86Cluster environment configuration and use . . . . 87
Overview of cluster environments . . . . . . 88Active/Active: Pool cluster resources . . . . 88Active/Passive: Fault tolerant . . . . . . 88Concurrent access . . . . . . . . . . 88
Configuring the backup-archive client in a clusterenvironment . . . . . . . . . . . . . 88Enabling Tivoli Storage Manager web clientaccess in a Cluster Environment . . . . . . 94Migrating legacy AIX IBM PowerHASystemMirror setups . . . . . . . . . . 96
AIX configuration considerations prior toperforming snapshot-based file backups andarchives . . . . . . . . . . . . . . . 97Configuring NetApp and Tivoli Storage Managerfor snapshot difference incremental backups . . . 98
SnapMirror support for NetAppsnapshot-assisted progressive incremental backup(snapdiff) . . . . . . . . . . . . . . 99
Register your workstation with a server . . . . 102Closed registration . . . . . . . . . . 102Open registration . . . . . . . . . . . 103
Creating an include-exclude list . . . . . . . 103Include-exclude options . . . . . . . . . 104
Exclude file spaces and directories . . . . 104Exclude files and directories from ajournal-based backup. . . . . . . . . 105Control processing with exclude statements 105System files to exclude . . . . . . . . 107Include and exclude files that containwildcard characters . . . . . . . . . 108Include and exclude groups of files withwildcard characters . . . . . . . . . 109Examples using wildcards with include andexclude patterns . . . . . . . . . . 110
Symbolic link and alias processing . . . . . 111Determine compression and encryptionprocessing . . . . . . . . . . . . . 111Preview include-exclude list files . . . . . . 112Include and exclude option processing . . . . 113
Chapter 3. Getting started . . . . . . 117Tivoli Storage Manager client authentication . . . 117Starting a Java GUI session . . . . . . . . . 118
Tivoli Storage Manager password. . . . . . 119Setup wizard . . . . . . . . . . . . 119
Starting a command-line session . . . . . . . 119Using batch mode . . . . . . . . . . . 120Issuing a series of commands by usinginteractive mode . . . . . . . . . . . 120
Specifying input strings that contain blank spacesor quotation marks . . . . . . . . . . . 121Starting: Additional considerations . . . . . . 121Starting a web client session . . . . . . . . 122
User privileges . . . . . . . . . . . . 122Start the client scheduler automatically . . . . . 123Changing your password . . . . . . . . . 123Sorting file lists using the Tivoli Storage ManagerGUI . . . . . . . . . . . . . . . . 125Displaying online help . . . . . . . . . . 126Ending a session . . . . . . . . . . . . 126Online forums . . . . . . . . . . . . . 126
Chapter 4. Backing up your data . . . 129Planning your backups . . . . . . . . . . 129Which files are backed up . . . . . . . . . 129When to back up and when to archive files . . . 130Pre-backup considerations (UNIX and Linux). . . 131
LAN-free data movement . . . . . . . . 131LAN-free prerequisites . . . . . . . . 131LAN-free data movement options . . . . 131
Incremental backups on memory-constrainedsystems . . . . . . . . . . . . . . 132Incremental backups on systems with a largenumber of files . . . . . . . . . . . . 132Include-exclude options to control processing 134
iv IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
Data encryption during backup or archiveoperations . . . . . . . . . . . . . 134File system and ACL support . . . . . . . 135Maximum file size for operations. . . . . . 138Long user and group names . . . . . . . 139Mac OS X volume names . . . . . . . . 139
Mac OS X volume naming precautions . . . 139Mac OS X volume naming precautions ondual boot systems . . . . . . . . . . 140
Mac OS X Unicode enablement . . . . . . 140Mac OS X Time Machine backup disk . . . . 141
Performing an incremental, selective, orincremental-by-date backup (UNIX and Linux) . . 142
Full and partial incremental backup . . . . . 142Journal-based backup on AIX and Linux . . 144
Incremental-by-date backup . . . . . . . 146Comparing incremental-by-date, journal-based,and NetApp snapshot difference to fullincremental and partial incremental backups . . 146Snapshot differential backup with an HTTPSconnection . . . . . . . . . . . . . 148
Running a snapshot differential backup withan HTTPS connection . . . . . . . . 149
Selective backup . . . . . . . . . . . 149Solaris global zone and non-global zonesbackups . . . . . . . . . . . . . . 150Saving access permissions . . . . . . . . 150Setting a virtual mount point . . . . . . . 150Backing up data using the Java GUI . . . . . 150Backing up data using the command line . . . 151Deleting backup data . . . . . . . . . . 154Deleting file spaces . . . . . . . . . . 154
Backing up files from one or more file spaces for agroup backup (UNIX and Linux) . . . . . . . 155Backing up data with client-node proxy support(UNIX and Linux) . . . . . . . . . . . . 156
Enabling multiple node operations from theGUI . . . . . . . . . . . . . . . 157Setting up encryption . . . . . . . . . 157Scheduling backups with client-node proxysupport . . . . . . . . . . . . . . 157
Examples of how to schedule a backup of anIBM PowerHA SystemMirror cluster. . . . 158Scheduling a backup of a GPFS file system 160
Associate a local snapshot with a server file space(UNIX and Linux) . . . . . . . . . . . . 161Image backup . . . . . . . . . . . . . 161
Performing prerequisite tasks before creating animage backup . . . . . . . . . . . . 162
Volume device type support for an imagebackup . . . . . . . . . . . . . 163
Utilizing image backups to perform file systemincremental backups . . . . . . . . . . 165
Method 1: Using image backups with filesystem incremental backups . . . . . . 165Method 2: Using image backups withincremental-by-date image backups . . . . 166Comparing methods 1 and 2 . . . . . . 166
Performing an image backup using the GUI . . 167Performing an image backup using thecommand line . . . . . . . . . . . . 168
Snapshot-based file backup and archive andsnapshot-based image backup . . . . . . . . 168Protecting Btrfs file systems . . . . . . . . 169
Backing up and restoring Btrfs file systems . . 170Backing up and restoring Btrfs subvolumes . . 171
Back up NAS file systems using Network DataManagement Protocol . . . . . . . . . . 172
Backing up NAS file systems with the webclient GUI using NDMP protocol . . . . . . 173Back up NAS file systems using the commandline. . . . . . . . . . . . . . . . 175
Backup network file systems . . . . . . . . 176Back up NFS file systems with the globalnamespace feature. . . . . . . . . . . 177
Back up AIX workload partition file systems . . . 178Backing up Solaris Zettabyte file systems . . . . 179AIX JFS2 encrypted file system backup . . . . . 180Back up AIX JFS2 extended attributes . . . . . 181Backing up VMware virtual machines . . . . . 181
Preparing the environment for full backups ofVMware virtual machines . . . . . . . . 183Creating full backups for VMware virtualmachines . . . . . . . . . . . . . . 183Parallel backups of virtual machines. . . . . 185
Back up and archive Tivoli Storage ManagerFastBack data . . . . . . . . . . . . . 189Display backup processing status. . . . . . . 190Backup (UNIX and Linux): Additionalconsiderations . . . . . . . . . . . . . 192
Stored files . . . . . . . . . . . . . 192Special file systems . . . . . . . . . . 193NFS or virtual mount points . . . . . . . 194Management classes . . . . . . . . . . 194Back up symbolic links . . . . . . . . . 194
Examples: Incremental or selective backup ofsymbolic links . . . . . . . . . . . 194Incremental backup of a domain only . . . 196
Hard links . . . . . . . . . . . . . 196Sparse files . . . . . . . . . . . . . 197NFS hard and soft mounts . . . . . . . . 197Deleted file systems . . . . . . . . . . 198Opened files. . . . . . . . . . . . . 198Wildcard characters . . . . . . . . . . 199
Chapter 5. Restoring your data . . . . 201Restoring an image . . . . . . . . . . . 201
Restoring an image using the GUI . . . . . 202Restoring an image using the command line . . 203
Restore data from a backup set . . . . . . . 204Restore backup sets: considerations andrestrictions . . . . . . . . . . . . . 206Backup set restore . . . . . . . . . . . 207Restoring backup sets using the GUI . . . . 208Backup set restores using the clientcommand-line interface . . . . . . . . . 209
Restoring or retrieving data during a failover. . . 209Restore an image to file . . . . . . . . . . 210Manage GPFS file system data with storage pools 211Restoring data to a point in time . . . . . . . 212Restore AIX encrypted files. . . . . . . . . 214Restore AIX workload partition file systems . . . 214
Contents v
|||||
Restore NAS file systems . . . . . . . . . 216Restoring NAS file systems using the Web client 216Options and commands to restore NAS filesystems from the command line . . . . . . 217
Restore active or inactive backups . . . . . . 218Restoring data using the GUI . . . . . . . . 218Command line restore examples . . . . . . . 219
Examples: Command line restores for largeamounts of data . . . . . . . . . . . 220Standard query restore, no-query restore, andrestartable restore . . . . . . . . . . . 221
Standard query restore process . . . . . 221No-query restore process . . . . . . . 221Restartable restore process . . . . . . . 222
Restoring Solaris Zettabyte (ZFS) file systems . . 223Additional restore tasks . . . . . . . . . . 223
Authorizing another user to restore or retrieveyour files . . . . . . . . . . . . . . 223Restoring or retrieving files from another clientnode . . . . . . . . . . . . . . . 224Restore or retrieve files to another workstation 225Restoring a disk in case of disk loss . . . . . 225Deleting file spaces . . . . . . . . . . 226Enable SELinux to restore files on the Red HatEnterprise Linux 5 client . . . . . . . . 227
Chapter 6. Archive and retrieve yourdata (UNIX and Linux). . . . . . . . 229Archive files. . . . . . . . . . . . . . 229
Archiving data with the GUI . . . . . . . 229Archive data examples by using the commandline. . . . . . . . . . . . . . . . 230
Associate a local snapshot with a server filespace . . . . . . . . . . . . . . 231
Archiving data with client node proxy . . . . 231Deleting archive data . . . . . . . . . . 233Advanced archive tasks . . . . . . . . . 233
Access permissions . . . . . . . . . 233Archive and retrieve symbolic links . . . . 234Hard links . . . . . . . . . . . . 235
Retrieve archives . . . . . . . . . . . . 235Retrieving data with the GUI . . . . . . . 235Retrieve data examples by using the commandline. . . . . . . . . . . . . . . . 236Archive management classes . . . . . . . 237
Chapter 7. Tivoli Storage Managerscheduler overview . . . . . . . . . 239Examples: Blank spaces in file names in scheduledefinitions . . . . . . . . . . . . . . 240Preferential start times for certain nodes . . . . 240Scheduler processing options . . . . . . . . 241
Evaluate schedule return codes in schedulescripts . . . . . . . . . . . . . . . 242Return codes from preschedulecmd andpostschedulecmd scripts . . . . . . . . . 243
Client-acceptor scheduler services versus thetraditional scheduler services . . . . . . . . 244Set the client scheduler process to run as abackground task and start automatically at startup . 244
Examples: Display information about scheduledwork . . . . . . . . . . . . . . . . 246Display information about completed work . . . 248Specify scheduling options . . . . . . . . . 249Scheduler options for commands . . . . . . . 249Enable or disable scheduled commands . . . . 249Manage multiple schedule requirements on onesystem . . . . . . . . . . . . . . . 250
Chapter 8. Client return codes . . . . 253
Chapter 9. Storage managementpolicies . . . . . . . . . . . . . . 255Policy domains and policy sets . . . . . . . 255Management classes and copy groups . . . . . 256Display information about management classesand copy groups . . . . . . . . . . . . 257
Copy group name attribute. . . . . . . . 257Copy type attribute . . . . . . . . . . 257Copy frequency attribute . . . . . . . . 258Versions data exists attribute . . . . . . . 258Versions data deleted attribute . . . . . . 258Retain extra versions attribute . . . . . . . 258Retain only version attribute . . . . . . . 258Copy serialization attribute . . . . . . . . 259Copy mode parameter . . . . . . . . . 259Copy destination attribute . . . . . . . . 260Retain versions attribute. . . . . . . . . 260Deduplicate data attribute . . . . . . . . 260
Select a management class for files . . . . . . 260Assign a management class to files . . . . . . 261Override the management class for archived files 262Select a management class for directories . . . . 262Bind management classes to files . . . . . . . 263Rebind backup versions of files . . . . . . . 264Retention grace period . . . . . . . . . . 264Event-based policy retention protection. . . . . 265
Archive files on a data retention server . . . . 265
Chapter 10. Processing options . . . 267Processing options overview . . . . . . . . 267Communication options . . . . . . . . . . 267
TCP/IP options . . . . . . . . . . . 268Shared memory options . . . . . . . . . 269
Server options . . . . . . . . . . . . . 269Backup and archive processing options . . . . . 270Restore and retrieve processing options. . . . . 279Scheduling options . . . . . . . . . . . 282Format and language options . . . . . . . . 283Command processing options . . . . . . . . 284Authorization options . . . . . . . . . . 284Error processing options. . . . . . . . . . 285Transaction processing options . . . . . . . 285Web client options. . . . . . . . . . . . 286Diagnostics options . . . . . . . . . . . 286Using options with commands . . . . . . . 287
Entering options with a command . . . . . 287Initial command-line-only options . . . . . 293Client options that can be set by the TivoliStorage Manager server . . . . . . . . . 293
vi IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
Client options reference . . . . . . . . . . 294Absolute . . . . . . . . . . . . . . 295Archmc . . . . . . . . . . . . . . . 296Archsymlinkasfile . . . . . . . . . . 297Asnodename . . . . . . . . . . . . . 297Auditlogging . . . . . . . . . . . . 298Auditlogname . . . . . . . . . . . . 301Autodeploy . . . . . . . . . . . . . 302Autofsrename . . . . . . . . . . . . 303Automount . . . . . . . . . . . . . 305Backmc . . . . . . . . . . . . . . . 306Backupsetname . . . . . . . . . . . . 307Basesnapshotname . . . . . . . . . . . 308Changingretries . . . . . . . . . . . 309Class . . . . . . . . . . . . . . . 310Collocatebyfilespec . . . . . . . . . . 311Commmethod . . . . . . . . . . . . . 312Commrestartduration . . . . . . . . . . 313Commrestartinterval . . . . . . . . . . 314Compressalways . . . . . . . . . . . . 314Compression . . . . . . . . . . . . . 315Console . . . . . . . . . . . . . . 317Createnewbase . . . . . . . . . . . . 317Datacenter . . . . . . . . . . . . . 319Datastore . . . . . . . . . . . . . 320Dateformat . . . . . . . . . . . . . 320Dedupcachepath . . . . . . . . . . . . 323Dedupcachesize . . . . . . . . . . . . 324Deduplication . . . . . . . . . . . . 325Defaultserver . . . . . . . . . . . . 326Deletefiles . . . . . . . . . . . . . 327Description . . . . . . . . . . . . . 327Detail . . . . . . . . . . . . . . . 328Diffsnapshot . . . . . . . . . . . . 330Diffsnapshotname . . . . . . . . . . . 331Dirmc . . . . . . . . . . . . . . . 332Dirsonly . . . . . . . . . . . . . . 333Disablenqr . . . . . . . . . . . . . 334Diskbuffsize . . . . . . . . . . . . 335Diskcachelocation . . . . . . . . . . 335Domain . . . . . . . . . . . . . . . 337Domain.image . . . . . . . . . . . . 341Domain.nas . . . . . . . . . . . . . 342Domain.vcd . . . . . . . . . . . . . 343Domain.vmfull . . . . . . . . . . . . 345Dontload . . . . . . . . . . . . . . 350Dynamicimage . . . . . . . . . . . . 351Efsdecrypt . . . . . . . . . . . . . 352Enablearchiveretentionprotection . . . . . 353Enablededupcache . . . . . . . . . . . 354Enablelanfree . . . . . . . . . . . . 355Encryptiontype . . . . . . . . . . . . 356Encryptkey . . . . . . . . . . . . . 357Errorlogmax . . . . . . . . . . . . . 359Errorlogname . . . . . . . . . . . . 361Errorlogretention . . . . . . . . . . 361Exclude options . . . . . . . . . . . 363
Controlling symbolic link and aliasprocessing . . . . . . . . . . . . 366Controlling compression processing . . . . 366Processing NAS file systems . . . . . . 367
Virtual machine exclude options . . . . . 367Fbbranch . . . . . . . . . . . . . . 369Fbclientname . . . . . . . . . . . . 370Fbpolicyname . . . . . . . . . . . . 371Fbreposlocation . . . . . . . . . . . 373Fbserver . . . . . . . . . . . . . . 374Fbvolumename . . . . . . . . . . . . 375Filelist . . . . . . . . . . . . . . 376Filename . . . . . . . . . . . . . . 379Filesonly . . . . . . . . . . . . . 380Followsymbolic . . . . . . . . . . . . 381Forcefailover . . . . . . . . . . . . 382Fromdate . . . . . . . . . . . . . . 383Fromnode . . . . . . . . . . . . . . 384Fromowner . . . . . . . . . . . . . 385Fromtime . . . . . . . . . . . . . . 385Groupname . . . . . . . . . . . . . 386Groups (deprecated) . . . . . . . . . . 387Guitreeviewafterbackup . . . . . . . . . 387Host . . . . . . . . . . . . . . . 388Httpport . . . . . . . . . . . . . . 388Hsmreparsetag . . . . . . . . . . . . 388Ieobjtype . . . . . . . . . . . . . 390Ifnewer . . . . . . . . . . . . . . 390Imagegapsize . . . . . . . . . . . . 391Imagetofile . . . . . . . . . . . . . 392Inactive . . . . . . . . . . . . . . 393Inclexcl . . . . . . . . . . . . . . 394
Considerations for Unicode-enabled clients 394Include options. . . . . . . . . . . . 395
Controlling symbolic link and aliasprocessing . . . . . . . . . . . . 400Compression and encryption backupprocessing . . . . . . . . . . . . 401Processing NAS file systems . . . . . . 401Virtual machine include options . . . . . 402
Incrbydate . . . . . . . . . . . . . 410Incremental . . . . . . . . . . . . . 412Lanfreecommmethod . . . . . . . . . . 412Lanfreeshmport . . . . . . . . . . . . 413Lanfreetcpport . . . . . . . . . . . . 414Lanfreessl . . . . . . . . . . . . . 415Lanfreetcpserveraddress . . . . . . . . 416Latest . . . . . . . . . . . . . . . 416Localbackupset . . . . . . . . . . . . 417Makesparsefile . . . . . . . . . . . . 418Managedservices . . . . . . . . . . . 419Maxcmdretries . . . . . . . . . . . . 421Mbobjrefreshthresh . . . . . . . . . . 422Mbpctrefreshthresh . . . . . . . . . . 423Memoryefficientbackup . . . . . . . . . 423Mode . . . . . . . . . . . . . . . 425Monitor . . . . . . . . . . . . . . 428Myreplicationserver . . . . . . . . . . 429Nasnodename . . . . . . . . . . . . . 431Nfstimeout . . . . . . . . . . . . . 432Nodename . . . . . . . . . . . . . . 433Nojournal . . . . . . . . . . . . . 434Noprompt . . . . . . . . . . . . . . 435Nrtablepath . . . . . . . . . . . . . 436Numberformat . . . . . . . . . . . . 437
Contents vii
Optfile . . . . . . . . . . . . . . 438Password . . . . . . . . . . . . . . 439Passwordaccess . . . . . . . . . . . . 441Passworddir . . . . . . . . . . . . . 443Pick . . . . . . . . . . . . . . . 443Pitdate . . . . . . . . . . . . . . 444Pittime . . . . . . . . . . . . . . 445Postschedulecmd/Postnschedulecmd . . . . . 446Postsnapshotcmd . . . . . . . . . . . 448Preschedulecmd/Prenschedulecmd . . . . . 449Preservelastaccessdate . . . . . . . . . 450Preservepath . . . . . . . . . . . . 451Presnapshotcmd . . . . . . . . . . . . 454Queryschedperiod . . . . . . . . . . . 455Querysummary . . . . . . . . . . . . 456Quiet . . . . . . . . . . . . . . . 457Quotesareliteral . . . . . . . . . . . 458Removeoperandlimit . . . . . . . . . . 459Replace . . . . . . . . . . . . . . 460Replserverguid . . . . . . . . . . . . 461Replservername . . . . . . . . . . . . 463Replsslport . . . . . . . . . . . . . 464Repltcpport . . . . . . . . . . . . . 466Repltcpserveraddress . . . . . . . . . 468Resourceutilization . . . . . . . . . . 470
Regulating backup and archive sessions . . 470Regulating restore sessions . . . . . . . 471Multiple client session considerations . . . 471
Retryperiod . . . . . . . . . . . . . 472Revokeremoteaccess . . . . . . . . . . 473Schedcmddisabled . . . . . . . . . . . 474Schedcmdexception . . . . . . . . . . 475Schedlogmax . . . . . . . . . . . . . 475Schedlogname . . . . . . . . . . . . 477Schedlogretention . . . . . . . . . . 478Schedmode . . . . . . . . . . . . . 480Schedrestretrdisabled . . . . . . . . . 481Scrolllines . . . . . . . . . . . . . 482Scrollprompt . . . . . . . . . . . . 483Servername . . . . . . . . . . . . . 484Sessioninitiation . . . . . . . . . . 485Shmport . . . . . . . . . . . . . . 487Showmembers . . . . . . . . . . . . . 488Skipacl . . . . . . . . . . . . . . 488Skipaclupdatecheck . . . . . . . . . . 489Snapdiff . . . . . . . . . . . . . . 490Snapdiffhttps . . . . . . . . . . . . 494Snapshotcachesize . . . . . . . . . . 496Snapshotproviderfs . . . . . . . . . . 497Snapshotproviderimage . . . . . . . . . 498Snapshotroot . . . . . . . . . . . . 499Srvoptsetencryptiondisabled . . . . . . . 501Srvprepostscheddisabled . . . . . . . . 502Srvprepostsnapdisabled . . . . . . . . . 503Ssl . . . . . . . . . . . . . . . . 504Sslfipsmode . . . . . . . . . . . . . 504Sslrequired . . . . . . . . . . . . . 505Ssldisablelegacytls . . . . . . . . . . 507Stagingdirectory . . . . . . . . . . . 508Subdir . . . . . . . . . . . . . . . 509Tapeprompt . . . . . . . . . . . . . 511
Tcpadminport . . . . . . . . . . . . 512Tcpbuffsize . . . . . . . . . . . . . 513Tcpcadaddress . . . . . . . . . . . . 513Tcpclientaddress . . . . . . . . . . . 514Tcpclientport . . . . . . . . . . . . 515Tcpnodelay . . . . . . . . . . . . . 516Tcpport . . . . . . . . . . . . . . 517Tcpserveraddress . . . . . . . . . . . 517Tcpwindowsize . . . . . . . . . . . . 518Timeformat . . . . . . . . . . . . . 519Toc . . . . . . . . . . . . . . . . 522Todate . . . . . . . . . . . . . . . 523Totime . . . . . . . . . . . . . . . 524Txnbytelimit . . . . . . . . . . . . 525Type . . . . . . . . . . . . . . . 526Updatectime . . . . . . . . . . . . . 527Useexistingbase . . . . . . . . . . . 527Usereplicationfailover . . . . . . . . . 528Users (deprecated). . . . . . . . . . . 529V2archive . . . . . . . . . . . . . 529Vappmc . . . . . . . . . . . . . . . 530Vcdhost . . . . . . . . . . . . . . 531Vcdpw . . . . . . . . . . . . . . . 532Vcduser . . . . . . . . . . . . . . 533Verbose . . . . . . . . . . . . . . 533Verifyimage . . . . . . . . . . . . . 534Virtualfsname . . . . . . . . . . . . 535Virtualmountpoint . . . . . . . . . . 535Virtualnodename . . . . . . . . . . . 537Vmbackdir . . . . . . . . . . . . . 538Vmbackuptype . . . . . . . . . . . . 538Vmmc . . . . . . . . . . . . . . . 539Vmchost . . . . . . . . . . . . . . 540Vmcpw . . . . . . . . . . . . . . . 541Vmctlmc . . . . . . . . . . . . . . 541Vmcuser . . . . . . . . . . . . . . 543Vmdefaultdvportgroup . . . . . . . . . 543Vmdefaultdvswitch . . . . . . . . . . 544Vmdefaultnetwork . . . . . . . . . . 545Vmenabletemplatebackups . . . . . . . . 546Vmlimitperdatastore . . . . . . . . . . 547Vmlimitperhost . . . . . . . . . . . . 548Vmmaxparallel . . . . . . . . . . . . 549Vmnoprdmdisks . . . . . . . . . . . . 550Vmnovrdmdisks . . . . . . . . . . . . 551Vmprocessvmwithindependent . . . . . . . 552Vmprocessvmwithprdm . . . . . . . . . . 553Vmskipctlcompression . . . . . . . . . 555Vmskipmaxvmdks. . . . . . . . . . . 555Vmverifyifaction . . . . . . . . . . . 556Vmverifyiflatest . . . . . . . . . . . 558Vmvstortransport . . . . . . . . . . . 559Vmtimeout . . . . . . . . . . . . . 560Webports . . . . . . . . . . . . . . 561Wildcardsareliteral . . . . . . . . . . 562
Chapter 11. Using commands . . . . 565Start and end a client command session . . . . 568
Process commands in batch mode . . . . . 568Process commands in interactive mode . . . . 568
viii IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
||||||
||||
Enter client command names, options, andparameters . . . . . . . . . . . . . . 569
Command name . . . . . . . . . . . 569Options . . . . . . . . . . . . . . 570
Options in interactive mode . . . . . . 570Parameters . . . . . . . . . . . . . 570File specification syntax . . . . . . . . . 571
Wildcard characters . . . . . . . . . . . 572Client commands reference . . . . . . . . . 573Archive . . . . . . . . . . . . . . . 573Archive FastBack . . . . . . . . . . . . 576Backup FastBack . . . . . . . . . . . . 578Backup Group . . . . . . . . . . . . . 580Backup Image . . . . . . . . . . . . . 582
Static, dynamic, and snapshot image backup 585Utilizing image backup to perform file systemincremental backup . . . . . . . . . . 586
Backup NAS . . . . . . . . . . . . . 588Backup VAPP . . . . . . . . . . . . . 590Backup VM . . . . . . . . . . . . . . 596Cancel Process . . . . . . . . . . . . . 601Cancel Restore . . . . . . . . . . . . . 601Delete Access . . . . . . . . . . . . . 602Delete Archive . . . . . . . . . . . . . 603Delete Backup . . . . . . . . . . . . . 604Delete Filespace . . . . . . . . . . . . 608Delete Group . . . . . . . . . . . . . 609Expire . . . . . . . . . . . . . . . . 610Help . . . . . . . . . . . . . . . . 612Incremental . . . . . . . . . . . . . . 613
Journal-based backup. . . . . . . . . . 617Incremental-by-Date . . . . . . . . . . 619Associate a local snapshot with a server filespace . . . . . . . . . . . . . . . 619
Loop . . . . . . . . . . . . . . . . 619Macro . . . . . . . . . . . . . . . . 621Monitor Process . . . . . . . . . . . . 622Preview Archive . . . . . . . . . . . . 622Preview Backup . . . . . . . . . . . . 623Query Access . . . . . . . . . . . . . 624Query Archive . . . . . . . . . . . . . 625Query Backup . . . . . . . . . . . . . 627
Query NAS file system images . . . . . . 630Query Backupset . . . . . . . . . . . . 630
Query Backupset without the backupsetnameparameter . . . . . . . . . . . . . 632
Query Filespace . . . . . . . . . . . . 633Query NAS file spaces . . . . . . . . . 635
Query Group . . . . . . . . . . . . . 635
Query Image . . . . . . . . . . . . . 637Query Inclexcl . . . . . . . . . . . . . 639Query Mgmtclass . . . . . . . . . . . . 640Query Node. . . . . . . . . . . . . . 640Query Options . . . . . . . . . . . . . 642Query Restore . . . . . . . . . . . . . 643Query Schedule . . . . . . . . . . . . 643Query Session . . . . . . . . . . . . . 644Query Systeminfo . . . . . . . . . . . 645Query VAPP . . . . . . . . . . . . . 646Query VM . . . . . . . . . . . . . . 650Restart Restore . . . . . . . . . . . . . 652Restore . . . . . . . . . . . . . . . 653
Restore from file spaces that are notUnicode-enabled . . . . . . . . . . . 657
Restore Backupset . . . . . . . . . . . 658Restore backup sets: considerations andrestrictions . . . . . . . . . . . . . 661Restore backup sets in a SAN environment . . 662Restore Backupset without the backupsetnameparameter . . . . . . . . . . . . . 662
Restore Group . . . . . . . . . . . . . 664Restore Image . . . . . . . . . . . . . 666Restore NAS . . . . . . . . . . . . . 669Restore VAPP . . . . . . . . . . . . . 671Restore VM . . . . . . . . . . . . . . 675Retrieve . . . . . . . . . . . . . . . 679
Retrieve archives from file spaces that are notUnicode-enabled . . . . . . . . . . . 682
Schedule . . . . . . . . . . . . . . . 682Selective . . . . . . . . . . . . . . . 684
Associate a local snapshot with a server filespace . . . . . . . . . . . . . . . 687
Set Access . . . . . . . . . . . . . . 687Set Event. . . . . . . . . . . . . . . 691Set password . . . . . . . . . . . . . 693
Appendix. Accessibility features forthe Tivoli Storage Manager productfamily. . . . . . . . . . . . . . . 699
Notices . . . . . . . . . . . . . . 701
Glossary . . . . . . . . . . . . . 705
Index . . . . . . . . . . . . . . . 707
Contents ix
x IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
Tables
1. Minimum disk space needed for automaticclient deployment . . . . . . . . . . . 3
2. Default log file location. . . . . . . . . . 43. AIX client communication methods . . . . . 54. Supported features on AIX . . . . . . . . 55. HP-UX Itanium 2 client communication
methods . . . . . . . . . . . . . . 66. Linux on Power Systems client communication
methods . . . . . . . . . . . . . . 77. Linux on Intel x86_64 client communication
methods . . . . . . . . . . . . . . 88. Linux on System z client communication
methods . . . . . . . . . . . . . . 99. Mac OS X client communication methods 9
10. Oracle Solaris client communication methods 1011. AIX client: Language codes for installation
packages . . . . . . . . . . . . . 1412. HP-UX Itanium 2 client: Language codes for
installation packages . . . . . . . . . 1713. Package names, contents, and default directory 2014. Language pack identifiers . . . . . . . . 2215. Package names, contents, and default directory 2416. Language pack identifiers . . . . . . . . 2617. Package names, contents, and default directory 2818. Language pack identifiers . . . . . . . . 3019. Package names, contents, and default directory 3220. Language pack identifiers . . . . . . . . 3521. Installation package names and descriptions 3822. Language installation commands . . . . . 4123. Tasks for root users, authorized users, and
other users . . . . . . . . . . . . . 4324. Mac OS X authorization tools and associated
Tivoli Storage Manager applications . . . . 4525. Client acceptor-managed services versus
traditional scheduler services. . . . . . . 5726. Data deduplication settings: Client and server 7627. Options for excluding file spaces and
directories . . . . . . . . . . . . 10528. Options for controlling processing using
include and exclude statements . . . . . 10629. Wildcard and other special characters 10930. Using wildcard characters with include and
exclude patterns . . . . . . . . . . 11031. Options for controlling symbolic link and
alias processing . . . . . . . . . . . 11132. Options for controlling compression and
encryption . . . . . . . . . . . . 11233. Working with your files using the Tivoli
Storage Manager GUI . . . . . . . . . 12534. Supported file systems and ACL support 13535. Maximum file size . . . . . . . . . . 13836. Command-line backup examples . . . . . 15137. Volume device-type support for an image
backup. . . . . . . . . . . . . . 16338. Comparing incremental image backup
methods . . . . . . . . . . . . . 167
39. LVM1 and LVM2 image operationcomparisons . . . . . . . . . . . . 168
40. NAS options and commands . . . . . . 17541. Backup and restore capabilities for VMware
virtual machines on Linux platforms . . . . 18142. Client command line informational messages 19043. Backup set GUI restore restrictions . . . . 20544. Backup set command-line restore restrictions 20545. Sample WPAR restore commands with
dsm.opt file . . . . . . . . . . . . 21546. NAS options and commands . . . . . . 21747. Command-line restore examples . . . . . 21948. Command line archive examples . . . . . 23049. Symbolic link management table for archive
and retrieve . . . . . . . . . . . . 23450. Command line examples of retrieving
archives . . . . . . . . . . . . . 23651. Sample classic query schedule output 24752. Sample enhanced query schedule output 24853. Client return codes and their meanings 25354. Default attribute values in the standard
management class . . . . . . . . . . 25755. TCP/IP options . . . . . . . . . . . 26856. Shared memory communication options 26957. Sample client system-options file . . . . . 27058. Backup and archive processing options 27059. Restore and retrieve processing options 27960. Scheduling options. . . . . . . . . . 28261. Format and language options . . . . . . 28362. Command processing options . . . . . . 28463. Authorization options. . . . . . . . . 28464. Error processing options . . . . . . . . 28565. Transaction processing options . . . . . . 28566. Web client options . . . . . . . . . . 28667. Diagnostics options . . . . . . . . . 28668. Client command options . . . . . . . . 28869. Options that are valid on the initial command
line only . . . . . . . . . . . . . 29370. Options that can be set by the Tivoli Storage
Manager server . . . . . . . . . . . 29471. Sample time format settings in the locale
configuration (t_fmt line) . . . . . . . 32372. Sample date format settings in the locale
configuration (d_fmt line) . . . . . . . 32373. Interaction of domain definitions from several
sources. . . . . . . . . . . . . . 34074. Other optional parameters . . . . . . . 39975. Incremental command: Related options 49276. Effects of server and client SSL settings on
success or failure of login attempts . . . . 50677. Sample time format settings in the locale
configuration (t_fmt line) . . . . . . . 52178. Sample date format settings in the locale
configuration (d_fmt line) . . . . . . . 52279. Commands . . . . . . . . . . . . 56580. Wildcard characters . . . . . . . . . 572
© Copyright IBM Corp. 1993, 2015 xi
||||
81. Archive command: Related options . . . . 57482. Archive FastBack command: Related options 57783. Backup FastBack command: Related options 57984. Backup Group command: Related options 58285. Backup Image command: Related options 58486. Backup NAS command: Related options 58987. Backup VAPP command: Related options 59288. Delete Archive command: Related options 60389. Delete Backup command: Related options 60690. Delete Filespace command: Related options 60891. Delete Group command: Related options 61092. Expire command: Related options . . . . . 61193. Incremental command: Related options 61594. Query Archive command: Related options 62695. Query Backup command: Related options 62896. Query Backupset command: Related options 63197. Query Backupset command: Related options 63398. Query Filespace command: Related options 63499. Query Group command: Related options 636
100. Query Image command: Related options 638101. Query Mgmtclass command: Related options 640102. Query Node command: Related options 641103. Query Options command: Related options 642104. Query Systeminfo command: Related options 646105. Restore VAPP command: Related options 648106. Query VM command: Related options for
VMware virtual machine queries. . . . . . 650107. Restore command: Related options . . . . 655108. Restore Backupset command: Related options 659109. Restore Group command: Related options 665110. Restore Image command: Related options 668111. Restore NAS command: Related options 671112. Restore VAPP command: Related options 673113. Restore VM command: Related options when
restoring VMware virtual machines . . . . 678114. Retrieve command: Related options . . . . 680115. Schedule command: Related options . . . . 683116. Selective command: Related options . . . . 686
xii IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
About this publication
IBM® Tivoli® Storage Manager is a client/server licensed product that providesstorage management services in a multiplatform computer environment.
The backup-archive client program enables users to back up and archive files fromtheir workstations or file servers to storage, and restore and retrieve backupversions and archived copies of files to their local workstations.
In addition to the backup-archive client, Tivoli Storage Manager includes thefollowing components:v A server program that acts as a backup and archive server for distributed
workstations and file servers.The server program also supplies hierarchical storage management (HSM)services, and enables systems to perform as a migration server.
v An administrative client program that you can access from a web browser orfrom the command line. The program enables a Tivoli Storage Manageradministrator to control and monitor server activities, define storagemanagement policies for backup, archive, and space management services, andset up schedules to perform those services at regular intervals.
v An application programming interface (API) that you can use to enhance anexisting application with storage management services. When an application isregistered with a server as a client node, the application can back up, restore,archive, and retrieve objects from storage.
v A web backup-archive client that enables an authorized administrator, help deskperson, or other users to perform backup, restore, archive, and retrieve servicesby using a web browser on a remote system.
Associated with Tivoli Storage Manager, but sold separately, are the Tivoli StorageManager for Space Management and Tivoli Storage Manager HSM for Windowsclient programs. These products automatically migrate eligible files to storage tomaintain specific levels of free space on local file systems and automatically recallmigrated files when they are accessed. It also enables users to migrate and recallspecific files.
The terms hierarchical storage management and space management have the samemeaning throughout this publication.
Who should read this publicationThis publication provides instructions for a user to install, configure, and use theTivoli Storage Manager client.
PublicationsThe Tivoli Storage Manager product family includes IBM Tivoli StorageFlashCopy® Manager, IBM Tivoli Storage Manager for Space Management, IBMTivoli Storage Manager for Databases, and several other storage managementproducts from IBM.
© Copyright IBM Corp. 1993, 2015 xiii
To view IBM product documentation, see www.ibm.com/support/knowledgecenter.
Conventions used in this publicationThis publication uses the following typographical conventions:
Example Description
autoexec.ncfhsmgui.exe
A series of lowercase letters with an extension indicates program filenames.
DSMI_DIR A series of uppercase letters indicates return codes and other values.
dsmQuerySessInfo Boldface type indicates a command that you type on a command line,the name of a function call, the name of a structure, a field within astructure, or a parameter.
timeformat Boldface italic type indicates a Tivoli Storage Manager option. Thebold type is used to introduce the option, or used in an example.
dateformat Italic type indicates an option, the value of an option, a new term, aplaceholder for information you provide, or for special emphasis in thetext.
maxcmdretries Monospace type indicates fragments of a program or information as itmight appear on a display screen, such a command example.
plus sign (+) A plus sign between two keys indicates that you press both keys at thesame time.
Reading syntax diagramsTo read a syntax diagram for entering a command, follow the path of the line.Read from left to right and from top to bottom.v The ��─── symbol indicates the beginning of a syntax diagram.v The ───� symbol at the end of a line indicates that the syntax diagram continues
on the next line.v The �─── symbol at the beginning of a line indicates that a syntax diagram
continues from the previous line.v The ───�� symbol indicates the end of a syntax diagram.
Syntax items, such as a keyword or a variable, can be:v On the line (required element)v Above the line (default element)v Below the line (optional element)
Symbols
Enter these symbols exactly as they appear in the syntax diagram.v * Asteriskv { } Bracesv : Colonv , Commav = Equal Signv - Hyphenv () Parentheses
xiv IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
http://www.ibm.com/support/knowledgecenterhttp://www.ibm.com/support/knowledgecenter
v . Periodv Spacev " quotation markv 'single quotation mark
Variables
Italicized lowercase items such as indicate variables. In this example,you can specify a when you enter the cmd_name command.
�� cmd_name ��
Repetition
An arrow returning to the left means that the item can be repeated. A characterwithin the arrow means that you must separate repeated items with that character.
�� �
,
repeat ��
A footnote (1) by the arrow refers to a limit that tells how many times the item canbe repeated.
�� �
,(1)
repeat ��
Notes:
1 Specify repeat up to 5 times.
Required choices
When two or more items are in a stack and one of them is on the line, you mustspecify one item.
In this example, you must choose A, B, or C.
�� cmd_name ABC
��
Optional choices
When an item is below the line, that item is optional. In the first example, you canselect A or nothing at all.
�� cmd_nameA
��
About this publication xv
When two or more items are in a stack below the line, all of them are optional. Inthe second example, you can choose A, B, C, or nothing at all.
�� cmd_nameABC
��
Repeatable choices
A stack of items followed by an arrow returning to the left indicates that you canselect more than one item, or in some cases, repeat a single item.
In this example, you can select any combination of A, B, or C.
�� �
,
cmd_name ABC
��
Defaults
Defaults are above the line. The default is selected unless you override it, or youcan select the default explicitly. To override the default, include an option from thestack below the line.
In this example, A is the default. Select either B or C to override A.
��A
cmd_nameBC
��
xvi IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
New for IBM Tivoli Storage Manager Version 7.1.2
Tivoli Storage Manager backup-archive client version 7.1.2 contains new featuresand changes.
Changed and new information is indicated by a vertical bar (|) to the left of thechange. Ensure that you are using the correct edition for the level of the product.v The Tivoli Storage Manager API is now supported on Linux distributions that
are running on IBM Power 8 Little Endian (LE) platforms.Instructions for installing the API on this platform are on the web athttp://www.ibm.com/support/docview.wss?uid=swg21690409.
v The backup-archive client is now supported on Ubuntu Linux 14.04, 64-bit. Newtopics have been added to document how to install or uninstall the client andcomponents on Ubuntu.For installation instructions see Installing the Tivoli Storage Manager Ubuntu Linuxx86_64 client. To uninstall the client from Ubuntu, see Uninstalling the TivoliStorage Manager Ubuntu Linux x86_64 client.
v For VMware backup operations, an INCLUDE.VMSNAPSHOTATTEMPS client option hasbeen added. This option determines the total number of snapshot attempts to tryfor a VMware virtual machine that fails during backup processing, due to asnapshot failure.For a description of the option settings, see theINCLUDE.VMSNAPSHOTATTEMPTS topic.
v The documentation has been updated to include information from APARs.
© Copyright IBM Corp. 1993, 2015 xvii
|
|
||
||
||
||
|||
|||
||||
||
|
http://www.ibm.com/support/docview.wss?uid=swg21690409
xviii IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
Chapter 1. Installing the Tivoli Storage Managerbackup-archive clients
The IBM Tivoli Storage Manager backup-archive client helps you protectinformation on your workstations.
You can maintain backup versions of your files that you can restore if the originalfiles are damaged or lost. You can also archive infrequently used files, preservethem in their current state, and retrieve them when necessary.
The Tivoli Storage Manager clients work in conjunction with the Tivoli StorageManager server. Contact your Tivoli Storage Manager server administrator toobtain backup or archive access to the server, or refer to the server publications toinstall and configure a Tivoli Storage Manager server.
Upgrading the backup-archive clientThe following sections explain what you need to do if you are upgrading to IBMTivoli Storage Manager backup-archive client Version 7.1.2 from a previous version.
Upgrade path for clients and serversTivoli Storage Manager clients and servers can be upgraded at different times. Thecombination of servers and clients that you deploy must be compatible with eachother.
To prevent disruption of your backup and archive activities while you upgradefrom one release to another, follow the compatibility guidelines for Tivoli StorageManager clients and servers. These guidelines are available on the web; to view theguidelines browse to http://www.ibm.com/support/docview.wss?uid=swg21053218.
For information about upgrading your current AIX®IBMPowerHA® SystemMirror®
setups, see “Migrating legacy AIX IBM PowerHA SystemMirror setups” on page96.
Additional upgrade informationWhen you upgrade a Tivoli Storage Manager client, there are additional things toconsider before you use the new client software.
For Mac users, updates to the Mac OS X client contained in Tivoli Storage Manager6.3, or newer versions, require you to consider the following items:v When you use the Mac OS X client that is provided in this release, ensure that
the dsm.sys and dsm.opt files are encoded by using Unicode (UTF-8). UTF-8encoding enables the use of characters from any language in the options files. Ifyour dsm.sys or dsm.opt files were previously encoded as MacRoman (oranything other than UTF-8), open them in an editor like TextEdit and save themwith UTF-8 encoding, and without the .txt extension. Your include-exclude listscan be encoded as either UTF-8 or UTF-16. For more information about usingUnicode, see “Considerations for Unicode-enabled clients” on page 394.
v Tivoli Storage Manager server file spaces that were created by Mac OS 9 clientscannot be managed by the Mac OS X client that was provided in Tivoli Storage
© Copyright IBM Corp. 1993, 2015 1
http://www.ibm.com/support/docview.wss?uid=swg21053218http://www.ibm.com/support/docview.wss?uid=swg21053218
Manager 6.3. Use q file node f=d on the server to list files stored for a givennode. Any Mac-platform files that do not start with a slash (/) might have beencreated by an older Mac client. You cannot restore or otherwise manage thesefiles by using the Mac OS X client that is provided in this release. You canmanage these files, but you must use a Mac client that is installed on a TivoliStorage Manager 6.22 (or older) node.
When you install the web client, you must install the web-client language files thatcorrespond to those languages you want to use. To view the online help from theweb client applet in languages other than English, you must install the languageversions of the help files on the agent, the system where the Tivoli StorageManager backup-archive client was installed. If the language versions are notinstalled or are not available, the online help is displayed in English.
For a list of new and changed messages since the previous Tivoli Storage Managerrelease, see the client_message.chg file in the client package.
Automatic backup-archive client deploymentThe Tivoli Storage Manager server administrator can automatically deploy abackup-archive client to workstations that already have the backup-archive clientinstalled.
When you schedule automatic Backup-Archive client deployments, the updatedclient packages (which include the client components and the API library) areinstalled on the workstations that receive them. A dependency check is performedby the client installation program to ensure that the API library does not conflictwith the client package that is already installed.
Tivoli Storage Manager for ERP applications do not use the same installationtechnology that is used by the client installation program. Because of that, theclient installation dependency check is not able to detect whether the API librarythat is being used by the Tivoli Storage Manager for ERP applications iscompatible with the API library that will be installed by automatic clientdeployments. If a client package is automatically deployed to and installed on aworkstation, the API library that is installed might not be compatible with the APIlibrary that was installed by the Tivoli Storage Manager for ERP application. Thenewly deployed API library can cause the Tivoli Storage Manager for ERPapplications to fail.
Do not schedule automatic client deployments to workstations that have a TivoliStorage Manager for ERP application installed on them.
The Tivoli Storage Manager server can be configured to automatically upgradebackup-archive clients on supported Linux and UNIX systems. The existing clientsmust be at version 5.5 or later.
Tivoli Storage Manager client distributions that are delivered with version 6.1 (andnewer) clients no longer contain the TIVsmCIBc (Traditional Chinese, Big 5)language pack. On Oracle Solaris x86_64 and Solaris SPARC systems, if youupgrade a version 5.5.x client that uses the TIVsmCIBc language pack to version6.1 (or newer), the TIVsmCIBc language pack is uninstalled. If you have theTraditional Chinese language pack installed (TIVsmCITc) no further action isneeded to display text that contains Traditional Chinese characters. If you do nothave the TIVsmCITc language pack installed, install it after the upgrade completes.
2 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
Important: For automatic client deployment to be operational, the followingconditions apply:v The client computer must have the minimum free disk space as shown in
Table 1.
Table 1. Minimum disk space needed for automatic client deployment
Operating systems Free disk space required
AIX 1500 MB
Solaris 1200 MB
HP-UX 900 MB
Linux on Power® 350 MB
Linux x86_64 950 MB
Linux on System z® 350 MB
Mac OS X 200 MB
v In Tivoli Storage Manager 6.3 and later, 32-bit backup-archive clients are nolonger supported. If the deployment manager detects a 32-bit backup-archiveclient running on a 64-bit operating system, it upgrades the client to the 64-bitversion.
v The passwordaccess option must be set to generate.To store the password on the client, a user must log on to local workstationonce, to provide the password. If the client automatic deployment processcannot find the node password, the following events occur:– The deployment process does not start.– A warning message is logged in the setup.log file.
The following messages are examples of the messages that can be loggedduring a deployment.Sun 10/11/2009 10:16:04.35 The deployclient.sh script is started.Sun 10/11/2009 10:16:04.37 deployclient.sh is removing the deployment
manager and temporary files possibly left from the previous installation.Sun 10/11/2009 10:17:10.53 WARNING: Still waiting for the result of query
system information.Ensure that "PASSWORDACCESS GENERATE" is set in the client options fileand that a connection to the server can be made without being promptedfor a password.
If you see these errors and PASSWORDACCESS is set to GENERATE, the errors areprobably caused by a network problem (the client cannot be reached).
– The dsmc query systeminfo command is left running.– The deployment process cannot start, so no messages are sent to the server.
v The client is deployed from the server as a scheduled task; the client schedulerdaemon must be running.
v The client is deployed as a postschedule operating system command; scheduledoperating system commands must be enabled on the client.
v You must configure your server to perform backup-archive client automaticdeployments. See the Tivoli Storage Manager server documentation forinstructions.
The deployment manager writes log and trace data for a deployment operation tothe client’s disk. The default location of the logs is shown in Table 2 on page 4. Thexxxx represents the version, release, modification, and fix pack information for thedeployed backup-archive client.
Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 3
Table 2. Default log file location.
Operating System Directory
AIX /usr/tivoli/client/IBM_ANR_UNX/Vxxxx/log/
Solaris, HP-UX, Linux /opt/tivoli/tsm/client/IBM_ANR_UNX/Vxxxx/log/
Mac /Library/Application Support/tivoli/tsm/client/ba/bin/IBM_ANR_MAC/Vxxxx/log
When you define a schedule to deploy the client updates, you can specify anon-default retrieval target location for UNIX and Linux platforms. Specifying anon-default retrieval target location changes the location of the log and trace files.For example, the default retrieval target location for AIX is /usr/tivoli/client/. Ifyou specify /tmp/tivoli/client as the target location, the log and trace files willbe under /tmp/tivoli/client/IBM_ANR_UNX/Vxxxx/log.
On the Mac OS X platform, you cannot change the retrieval target location. Thedeployment manager's working directory is relative to the working directory of theclient scheduler. For example, if the user starts the client scheduler from /mydir,the log and trace files will be under /mydir/IBM_AMR_MAC/Vxxxx/log.
A semaphore is used to prevent a client from being updated by differentdeployment managers at the same time. The semaphore expires 24 hours from thelast client deployment. New clients cannot be deployed until the semaphoreexpires.Related reference:“Autodeploy” on page 302
Client environment requirementsEach of the Tivoli Storage Manager clients has hardware and softwarerequirements.
The following list shows the location of the environment prerequisites for eachsupported platform.v “AIX client environment”v “HP-UX Itanium 2 client environment” on page 6v “Linux on POWER client environment” on page 6v “Linux x86_64 client environment” on page 7v “Linux on System z client environment” on page 8v “Mac OS X client environment” on page 9v “Oracle Solaris client environment” on page 10v “NDMP support requirements (Extended Edition only)” on page 10
For current information about the client environment prerequisites for all of thesupported Tivoli Storage Manager client platforms, go to the website athttp://www.ibm.com/support/docview.wss?&uid=swg21243309
AIX client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the AIX platform.
4 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
http://www.ibm.com/support/docview.wss?&uid=swg21243309
AIX client installable componentsThe Tivoli Storage Manager backup-archive client is comprised of severalinstallable components.
The installable components for the AIX client are as follows:v Tivoli Storage Manager backup-archive command line clientv Tivoli Storage Manager backup-archive administrative clientv Tivoli Storage Manager backup-archive client Graphical User Interface, which
uses Oracle Java™ technologyv Tivoli Storage Manager backup-archive web clientv Tivoli Storage Manager 64-bit API
The API can be separately installed. The other components are all installed whenyou install the AIX package (tivoli.tsm.client.api.64bit).
System requirements for the AIX clientThe Tivoli Storage Manager AIX client requires a minimum amount of hardware,disk space, memory, and software.
For software and hardware requirements for all supported versions of TivoliStorage Manager IBM AIX clients, including the most recent fix packs, see IBM AIXClient Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21052226.
AIX client communication methodsThe TCP/IP and shared memory communication methods are available for the AIXbackup-archive client.
You can use the following communication methods with the Tivoli StorageManager Version 7.1.2 AIX client:
Table 3. AIX client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (Standard withsupported AIX platforms)
AIX, HP-UX, Linux, Solaris,Windows
Shared Memory TCP/IP (Standard withsupported AIX platforms)
AIX
Backup-archive client features that are available on AIXThis topic lists the features that are supported on AIX.
Table 4. Supported features on AIX
Features Supported on AIX?
Backup-archive command-line and GUI yes
Journal-based backup yes
NetApp Snapshot Difference (snapdiff option) yes
LAN-free operations yes
Online image backup yes
Offline image backup yes
Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 5
http://www.ibm.com/support/docview.wss?uid=swg21052226
HP-UX Itanium 2 client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the HP-UX Itanium 2platform.
HP-UX Itanium 2 client installable componentsThe Tivoli Storage Manager command-line client, administrative client, Java GUI,web client, and API comprise the HP-UX Itanium 2 backup-archive clientinstallable components.
You can install the following components with Tivoli Storage Manager Version7.1.2:v Tivoli Storage Manager backup-archive command line clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager backup-archive Java Graphical User Interface (Java GUI)v Tivoli Storage Manager web backup-archive clientv Tivoli Storage Manager API (64-bit)
System requirements for HP-UX Itanium 2 clientsThe Tivoli Storage Manager HP-UX Itanium 2 client requires a minimum amountof hardware, disk space, memory, and software.
For software and hardware requirements for all supported versions of TivoliStorage Manager HP-UX Itanium 2 clients, including the most recent fix packs, seeHP-UX Itanium Client Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21197146.
HP-UX Itanium 2 client communication methodsThe TCP/IP and shared memory communication methods are available for theHP-UX Itanium 2 backup-archive client.
You can use the following communication methods with the Tivoli StorageManager Version 6.2 HP-UX Itanium 2 client:
Table 5. HP-UX Itanium 2 client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (Standard withHP-UX)
AIX, HP-UX, Linux, Solaris,Windows
Shared Memory TCP/IP (Standard withHP-UX)
HP-UX Itanium 2
Linux on POWER client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the Linux on POWER®
client platforms.
Linux on POWER client installable componentsThe Tivoli Storage Manager command-line, Java GUI, web backup-archive, andAPI comprise the Linux on POWER backup-archive client installable components.
You can install the following components with Tivoli Storage Manager Version7.1.2:
6 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
http://www.ibm.com/support/docview.wss?uid=swg21197146
v Tivoli Storage Manager backup-archive clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager backup-archive Java graphical user interface (Java GUI)v Tivoli Storage Manager Web backup-archive clientv Tivoli Storage Manager API (64-bit)
System requirements for Linux on Power clientsThe Tivoli Storage Manager Linux on Power clients require a minimum amount ofhardware, disk space, memory, and software.
For software and hardware requirements for all supported versions of TivoliStorage Manager Linux on Power clients, including the most recent fix packs, seeLinux on Power Client Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21169963.
Linux on Power Systems client communication methodsBackup-archive clients on Linux on Power Systems can use either TCP/IP orshared memory as the communications method for client-server communications.
Table 6 lists the available Linux on Power Systems client communications methods,and the Tivoli Storage Manager server operating systems that you can use themwith.
Table 6. Linux on Power Systems client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (Standard withLinux)
AIX, HP-UX, Linux, Solaris,Windows
Shared Memory TCP/IP (Standard withLinux)
Linux on Power Systems
Linux x86_64 client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the Linux on Intel(Linux x86_64) platform.
Linux x86_64 client installable componentsThe Tivoli Storage Manager command-line, Java GUI, web backup-archive,administrative client, and the API comprise the Linux on Intel (Linux x86_64)backup-archive client installable components.
You can install the following components with Tivoli Storage Manager Version7.1.2:v Tivoli Storage Manager backup-archive clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager backup-archive Java graphical user interface (Java GUI)v Tivoli Storage Manager Web backup-archive clientv Tivoli Storage Manager API
System requirements for Linux x86_64 clientsThe Tivoli Storage Manager Linux x86_64 clients require a minimum amount ofhardware, disk space, memory, and software.
Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 7
http://www.ibm.com/support/docview.wss?uid=swg21169963
For software and hardware requirements for all supported versions of TivoliStorage Manager Linux x86_64 clients, including the most recent fix packs, seeLinux x86/x86_64 Client Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21052223.
Linux x86_64 client communication methodsThe TCP/IP and shared memory communication methods are available for theLinux on Intel (Linux x86_64) backup-archive client.
You can use the following communication methods with the Tivoli StorageManager Version 7.1.2 Linux on Intel (Linux x86_64) client:
Table 7. Linux on Intel x86_64 client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (Standard withLinux)
AIX, HP-UX, Linux, Solaris,Windows
Shared Memory TCP/IP (Standard withLinux)
Linux x86_64
Linux on System z client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the Linux on System zplatform.
Linux on System z client installable componentsThe Tivoli Storage Manager command-line client, administrative client, webbackup-archive client, and API comprise the Linux on System z backup-archiveclient installable components.
You can install the following components with Tivoli Storage Manager Version7.1.2:v Tivoli Storage Manager backup-archive clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager web backup-archive clientv Tivoli Storage Manager API
System requirements for Linux on System z clientsTivoli Storage Manager Linux System z clients require a minimum amount ofhardware, disk space, memory, and software.
For software and hardware requirements for all supported versions of TivoliStorage Manager Linux System z clients, including the most recent fix packs, seeLinux zSeries Client Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21066436.
Linux on System z client communication methodsThe TCP/IP and shared memory communication methods are available for theLinux on System z backup-archive client.
You can use the following communication methods with the Tivoli StorageManager Version 7.1.2 Linux on System z client:
8 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
http://www.ibm.com/support/docview.wss?uid=swg21052223http://www.ibm.com/support/docview.wss?uid=swg21066436
Table 8. Linux on System z client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (Standard withLinux)
AIX, HP-UX, Linux, Solaris,Windows
Shared Memory TCP/IP (Standard withLinux)
Linux on System z
Mac OS X client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the Mac OS X client.
Mac OS X client installable componentsThe Tivoli Storage Manager command-line, Java GUI, Web backup-archive, andAPI comprise the Mac OS X backup-archive client installable components.
You can install the following components with Tivoli Storage Manager Version7.1.2:v Tivoli Storage Manager backup-archive clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager Web backup-archive clientv Tivoli Storage Manager APIv Tivoli Storage Manager Backup-Archive Java Graphical User Interface (GUI)
Tip: The dsmj shell script file for the Java GUI is installed in the followinglocation:/Library/Application Support/tivoli/tsm/client/ba/bin
System requirements for Mac OS X clientsThe Tivoli Storage Manager Mac OS X clients require a minimum amount ofhardware, disk space, memory, and software.
For software and hardware requirements for all supported versions of TivoliStorage Manager Mac OS X clients, including the most recent fix packs, see AppleMacintosh Client Requirements athttp://www.ibm.com/support/docview.wss?uid=swg21053584.
Mac OS X client communication methodsThe TCP/IP communication methods are available for the Mac OS Xbackup-archive client.
You can use the following communication methods with the Tivoli StorageManager Version 7.1.2 Mac OS X client:
Table 9. Mac OS X client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (standard with MacOS X)
AIX, HP-UX, Linux, Solaris,Windows
Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 9
http://www.ibm.com/support/docview.wss?uid=swg21053584
Oracle Solaris client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the Solaris platform.
Oracle Solaris client installable componentsThe Tivoli Storage Manager command-line, Java GUI, web backup-archive, andAPI comprise the Solaris backup-archive client installable components.
You can install the following components with Tivoli Storage Manager:v Tivoli Storage Manager backup-archive clientv Tivoli Storage Manager administrative clientv Tivoli Storage Manager backup-archive Java Graphical User Interface (Java GUI)v Tivoli Storage Manager Web backup-archive clientv Tivoli Storage Manager API
System requirements for Oracle Solaris clientsThe Tivoli Storage Manager Oracle Solaris clients require a minimum amount ofhardware, disk space, memory, and software.
For software and hardware requirements for all supported versions of TivoliStorage Manager Oracle Solaris clients, including the most recent fix packs. Toview the requirements, see the following IBM support pages:v Solaris SPARC Client Requirements, at
http://www.ibm.com/support/docview.wss?uid=swg21052211v Solaris x86/x86_64 Client Requirements, at http://www.ibm.com/support/
docview.wss?uid=swg21232956
Oracle Solaris client communication methodsThe TCP/IP and shared memory communication methods are available for theOracle Solaris backup-archive client.
You can use the following communication methods with the Tivoli StorageManager Oracle Solaris client:
Table 10. Oracle Solaris client communication methods
To use this communicationmethod:
Install this software: To connect to these TivoliStorage Manager servers:
TCP/IP TCP/IP (Standard withSolaris)
AIX, HP-UX, Linux, Solaris,Windows
Shared Memory TCP/IP (Standard withSolaris)
Solaris SPARC
NDMP support requirements (Extended Edition only)You can use the Network Data Management Protocol (NDMP) to back up andrestore network attached storage (NAS) file systems to tape drives or libraries thatare locally attached to Network Appliance and EMC Celerra NAS file servers.
NDMP support is available only on IBM Tivoli Storage Manager Extended Edition.
NDMP support requires the following hardware and software:v Tivoli Storage Manager Extended Edition
10 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
http://www.ibm.com/support/docview.wss?uid=swg21052211http://www.ibm.com/support/docview.wss?uid=swg21232956http://www.ibm.com/support/docview.wss?uid=swg21232956
v Tape drive and tape library. For supported combinations, go to:http://www.ibm.com/software/tivoli/products/storage-mgr/product-links.html
Installation requirements for backing up and archiving Tivoli StorageManager FastBack client data
Before you can back up or archive your FastBack client data, you must install therequired software.
You must install the following software:v Tivoli Storage Manager FastBack V6.1v Tivoli Storage Manager client V6.1.3.x (where x is 1 or higher) or V6.2 or laterv Tivoli Storage Manager server V6.1.3 or higherv Tivoli Storage Manager Administration Center V6.1.3
– Required only if you want to use integrated Tivoli Storage Manager FastBack- administration.Starting with Tivoli Storage Manager V7.1, the Administration Centercomponent is no longer included in Tivoli Storage Manager distributions.FastBack users who have an Administration Center from a previous serverrelease, can continue to use it to create and modify FastBack schedules. If youdo not already have an Administration Center installed, you can downloadthe previously-released version from ftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/LATEST. If you do notalready have an Administration Center installed, you must create and modifyFastBack schedules on the Tivoli Storage Manager server. For informationabout creating schedules on the server, see the Tivoli Storage Manager serverdocumentation.
The Tivoli Storage Manager FastBack environment must be running. Forinformation about installing and setting up Tivoli Storage Manager FastBack, seeTivoli Storage Manager FastBack Installation and User's Guide, at:http://www.ibm.com/support/knowledgecenter/SS9NU9
For information about integrating Tivoli Storage Manager and Tivoli StorageManager FastBack, see the IBM Tivoli Storage Manager Integration Guide for TivoliStorage Manager Fastback.
You can install Tivoli Storage Manager client in one of the following ways:v Install Tivoli Storage Manager client on a workstation where the FastBack DR
Hub is installed. In this case, the prerequisites are: the FastBack DisasterRecovery Hub setup, and the FastBack shell.
v Install Tivoli Storage Manager client on a workstation where neither theFastBack server or the FastBack Disaster Recovery Hub is installed. In this case,the FastBack shell is still required.
Related concepts:“Configuring the client to back up and archive Tivoli Storage Manager FastBackdata” on page 86
Installing from the Tivoli Storage Manager DVDsThe locations and instructions to install Tivoli Storage Manager from the DVDs arelisted in this topic.
Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 11
http://www.ibm.com/software/tivoli/products/storage-mgr/product-links.htmlftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/LATESTftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/LATESThttp://www.ibm.com/support/knowledgecenter/SS9NU9
IBM Tivoli Storage Manager AIX ClientContains the AIX client image. The AIX client image is in the/usr/sys/inst.images directory.
IBM Tivoli Storage Manager HP ClientContains the HP-UX client image. The image is in the tsmcli/hp11ia64/directory.
IBM Tivoli Storage Manager Linux ClientsContains the Linux x86_64, Linux on System z, and LinuxPPC clientimages. The images reside in the tsmcli/'platform’/ directory structure,where 'platform’ is one of the following platform designations: Linuxx86_64, Linux on System z, or LinuxPPC (for Linux on POWER client).
IBM Tivoli Storage Manager Mac OS X ClientContains the Mac OS X client images. The images reside in the tsmcli/macdirectory.
IBM Tivoli Storage Manager Solaris ClientContains the Solaris client images. For Solaris on x86_64 systems, theimages are in the tsmcli/solaris_x86 directory. For Solaris on SPARCsystems, the images are in the tsmcli/solaris_sparc directory.
Install the UNIX and Linux backup-archive clientsThis section provides instructions to install and set up Tivoli Storage ManagerUNIX and Linux clients.
Note: You must log on as the root user to install Tivoli Storage Manager on aUNIX or Linux workstation.
The supported UNIX and Linux clients and the location of the installationinstructions for each client are listed here.v “Installing the Tivoli Storage Manager AIX client”v “Installing the Tivoli Storage Manager HP-UX Itanium 2 client” on page 16v “Installing the Tivoli Storage Manager backup-archive client on Linux on Power
Systems” on page 19v “Installing the Tivoli Storage Manager Linux x86_64 client” on page 23v “Installing the Tivoli Storage Manager Linux on System z client” on page 32v “Installing the Tivoli Storage Manager Mac OS X client” on page 36v “Installing the Tivoli Storage Manager Solaris client” on page 38Related concepts:Chapter 2, “Configure the Tivoli Storage Manager client,” on page 43
Installing the Tivoli Storage Manager AIX clientYou can install the Tivoli Storage Manager AIX client from the product DVD, orother installation media.
In Tivoli Storage Manager 7.1.2, a 64-bit version of the AIX client is provided in thedistribution libraries. You cannot upgrade a previously installed 32-bit AIX client tonew the 64-bit AIX client. If you have a 32-bit client that is installed from aprevious version of Tivoli Storage Manager, use SMIT to perform the followingsteps:1. Uninstall the 32-bit client (tivoli.tsm.client.ba).2. Uninstall any national language files that were previously installed.
12 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
3. Uninstall the API (tivoli.tsm.client.api.32bit).
Next, use SMIT to install the following packages in the Tivoli Storage ManagerVersion 7.1.2 distribution libraries, in the following order:1. Install the 64-bit API (tivoli.tsm.client.api.64bit).2. Install the national language files that you need.3. Install the 64-bit client (tivoli.tsm.client.ba.64bit).
If you already have a 64-bit Tivoli Storage Manager Version 6.3 (or newer) clientinstalled, you can upgrade the client instead of uninstalling it and reinstalling it.
If you have a 64-bit client from an earlier version of Tivoli Storage Managerinstalled (for example, Version 6.1, or 6.2) you must uninstall the client, languagepacks, and API. Then, then install the new Tivoli Storage Manager API, languagepacks, and client.
All of the packages that are needed to install the client are in the Tivoli StorageManager AIX client package, and they overwrite any older runtime applications onyour system during installation. The LibC (C Set ++) runtime library is required.
When you use the installp command to install this client, do not change thedefault field values for the following two choices:v "AUTOMATICALLY install requisite software?"v "OVERWRITE same or newer versions?"Disabling or changing the values allows a lower level Tivoli Storage Managercomponent to install over a currently higher installed component. Under suchcircumstances, function calls between components at different levels might not bevalid any longer.
Install the following packages. They are all provided on the installation media. Youneed an Extended Edition license to use the NAS client.
The following files are listed in order of dependency. For example, the API isdependent on the Global Security Kit (GSKit). When you install all of them usingSMIT, you can select them (F7) in any order.
GSKit8.gskcrypt64.ppc.rte and GSKit8.gskssl64.ppc.rteIBM GSKit 64-bit (required by the 64-bit client API).
tivoli.tsm.client.api.64bitInstalls the 64-bit API.
tivoli.tsm.client.msg.langInstalls the NL messages for API, where lang is the appropriate languagecode from Table 11 on page 14.
tivoli.tsm.client.ba.64bitInstalls the following Tivoli Storage Manager 64-bit files:v Backup-archive Java client (GUI)v Backup-archive web clientv Hardware backup clientv Snapshot hardware backup clientv NAS backup client
tivoli.tsm.filepath_aixInstalls the file path kernel extension required for journal-based backup.
Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 13
tivoli.tsm.client.jbb.64bitInstalls the Tivoli Storage Manager journal-based backup component.
The default installation directory where each package is installed is listed below:v The Tivoli Storage Manager backup-archive, web client, and administrative client
(dsmadmc) 64-bit files are installed in the /usr/tivoli/tsm/client/ba/bin64directory.
v The Tivoli Storage Manager 64-bit API files are installed in the/usr/tivoli/tsm/client/api/bin64 directory.
v The sample system-options file, dsm.sys.smp, is placed in the installationdirectory.
Table 11. AIX client: Language codes for installation packages
Language Tivoli Storage Manager Language code
Simplified Chinese ZH_CN
Traditional Chinese ZH_TW
Czech CS_CZ
French FR_FR
German DE_DE
Hungarian HU_HU
Italian IT_IT
Japanese JA_JP
Korean KO_KR
Polish PL_PL
Brazilian Portuguese PT_BR
Russian RU_RU
Spanish ES_ES
This installation procedure can be used to install new distributions or updates froma DVD or other media. If you download files from Passport Advantage® or otherIBM web site, the files that you use to install the client might be compressed.Depending on the package file format, either copy or extract the files to disk anduse these instructions to install the components and optional language packs.
If you are copying the client files into a local directory first, a .toc file isautomatically created by the installp command. You can create a .toc filemanually by running /usr/sbin/inutoc in the local directory to which you copiedthe Tivoli Storage Manager image. From the AIX command line, enter:
/usr/sbin/inutoc /usr/sys/inst.images
A .toc file is created in that directory.1. Log in as the root user.2. Mount the volume or DVD that you are installing from.3. From the AIX command line, type smitty install and press Enter.4. Select Install and Update Software and press Enter.5. Select Install and Update From ALL Available Software and press Enter.
14 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide
6. At the INPUT device/directory for software prompt, press the F4 key andselect the DVD device that contains the installation DVD, or spec