IBMTivoli Storage Manager for UNIX and Linux Backup ......Installing the Tivoli Storage Manager...

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.


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



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



TCP/IP TCP/IP (Standard withHP-UX)


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:



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



TCP/IP TCP/IP (Standard withLinux)


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.



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






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:


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






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



TCP/IP TCP/IP (standard with MacOS X)




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



TCP/IP TCP/IP (Standard withSolaris)


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


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.


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.


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.


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.


6. At the INPUT device/directory for software prompt, press the F4 key andselect the DVD device that contains the installation DVD, or spec

Date post:	02-Feb-2021
Category:	Documents
Upload:	others
View:	9 times
Download:	0 times

IBMTivoli Storage Manager for UNIX and Linux Backup ......Installing the Tivoli Storage Manager...

Documents