IBM Tivoli Storage Manager for UNIX and Linux Backup ... · IBM T ivoli Stora ge Mana ger for UNIX and Linux Backup-Archive Clients V ersion 7.1.4 Installa tion and User's Guide IBM

IBM Tivoli Storage Manager for UNIX and LinuxBackup-Archive ClientsVersion 7.1.4

Installation and User's Guide

IBM

Note:Before you use this information and the product it supports, read the information in “Notices” on page 719.

Sixth edition (December 2015)

This edition applies to version 7, release 1, modification 4 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 . . . . . . . . . . . . .. xivConventions used in this publication . . . .. xivReading syntax diagrams . . . . . . . .. xiv

New for Tivoli Storage ManagerVersion 7.1.4. . . . . . . . . . .. 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 Systems client environment . .. 6Linux on Power Systems client installablecomponents. . . . . . . . . . . .. 6System requirements for clients on Linux onPower Systems . . . . . . . . . .. 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.. 10

System requirements for Oracle Solaris clients 10Oracle Solaris client communication methods 10

NDMP support requirements (Extended Editiononly) . . . . . . . . . . . . . . .. 10Installation requirements for backing up andarchiving Tivoli Storage Manager FastBack clientdata . . . . . . . . . . . . . . . .. 11Installing the backup-archive client from the TivoliStorage Manager DVDs . . . . . . . . .. 11Install the UNIX and Linux backup-archive clients 12

Installing the Tivoli Storage Manager AIX client 13Uninstalling 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 . . . . . . . . . . . . .. 20Uninstalling the Tivoli Storage Manager client onLinux on Power Systems . . . . . . . .. 23Installing the Tivoli Storage Manager client onLinux on Power Systems (Little Endian) . . .. 24Uninstalling the Tivoli Storage Manager client onLinux on Power Systems (Little Endian) . . .. 26Installing the Tivoli Storage Manager API onUbuntu Linux on Power Systems (Little Endian) . 27Uninstalling the Tivoli Storage Manager API onUbuntu Linux on Power Systems (Little Endian) . 28Installing the Tivoli Storage Manager Linuxx86_64 client . . . . . . . . . . . .. 28Uninstalling the Tivoli Storage Manager Linuxx86_64 client . . . . . . . . . . . .. 31Installing the Tivoli Storage Manager UbuntuLinux x86_64 client . . . . . . . . . .. 32Uninstalling the Tivoli Storage Manager UbuntuLinux x86_64 client . . . . . . . . . .. 35Installing the Tivoli Storage Manager Linux onSystem z client . . . . . . . . . . .. 36Uninstalling the Tivoli Storage Manager Linux onSystem z client . . . . . . . . . . .. 39Installing the Tivoli Storage Manager Mac OS Xclient . . . . . . . . . . . . . .. 40Uninstalling the Tivoli Storage Manager Mac OSX client . . . . . . . . . . . . . .. 41Installing the Tivoli Storage Manager Solarisclient . . . . . . . . . . . . . .. 42Uninstalling the Tivoli Storage Manager Solarisclient . . . . . . . . . . . . . .. 44Software updates . . . . . . . . . .. 45

Installing the client management service to collectdiagnostic information. . . . . . . . . .. 45

© Copyright IBM Corp. 1993, 2015 iii

||||||||||||

Chapter 2. Configure the Tivoli StorageManager client . . . . . . . . . .. 47UNIX and Linux client root and authorized usertasks. . . . . . . . . . . . . . . .. 47Enable non-administrators to manage their owndata . . . . . . . . . . . . . . . .. 49

Restricting Tivoli Storage Manager access to auser group. . . . . . . . . . . . .. 50Enabling encryption for Tivoli Storage Managerclient users . . . . . . . . . . . .. 50

Client options file overview . . . . . . . .. 51Creating and modifying the client system-optionsfile . . . . . . . . . . . . . . .. 53Creating a default client-user options file . .. 55Creating a customized client user-options file .. 56

Environment variables. . . . . . . . . .. 57Set language environment variables . . . .. 57Set processing environment variables . . . .. 58Set Bourne and Korn shell variables . . . .. 60Set C shell variables . . . . . . . . .. 60Set API environment variables . . . . . .. 61

Web client configuration overview. . . . . .. 61Configuring the web client on AIX, HP-UX,Linux, Mac, and Solaris systems . . . . .. 62

Configuring the scheduler . . . . . . . .. 62Comparison between client acceptor-managedservices and traditional scheduler services . .. 63Configuring the client to use the client acceptorservice to manage the scheduler . . . . .. 64

Start the client scheduler . . . . . . . . .. 65Scheduling events using the command-line client 65

Configuring Tivoli Storage Manager client/servercommunication across a firewall . . . . . .. 67Configuring Tivoli Storage Manager client/servercommunication with Secure Sockets Layer . . .. 69

Certificate Authorities root certificates . . .. 72Configure your system for journal-based backup .. 73

Journal daemon configuration . . . . . .. 73JournalSettings stanza . . . . . . . .. 74JournalExcludeList stanza . . . . . .. 75JournaledFileSystemSettings stanza . . .. 76Overriding stanzas . . . . . . . . .. 78

Client-side data deduplication . . . . . . .. 79Configuring the client for data deduplication .. 83Excluding files from data deduplication . . .. 85

Automated client failover configuration and use .. 86Automated client failover overview . . . .. 86

Requirements for automated client failover .. 87Restrictions for automated client failover .. 88Failover capabilities of Tivoli Storage Managercomponents . . . . . . . . . . .. 89

Configuring the client for automated failover .. 89Determining the status of replicated client data 91Preventing automated client failover . . . .. 92Forcing the client to fail over . . . . . .. 93

Configuring the client to back up and archive TivoliStorage Manager FastBack data . . . . . . .. 93Cluster environment configuration and use . . .. 94

Overview of cluster environments . . . . .. 95Active/Active: Pool cluster resources . . .. 95Active/Passive: Fault tolerant . . . . .. 95

Concurrent access . . . . . . . . .. 95Configuring the backup-archive client in a clusterenvironment . . . . . . . . . . . .. 95Enabling Tivoli Storage Manager web clientaccess in a Cluster Environment . . . . .. 101Migrating legacy AIX IBM PowerHASystemMirror setups . . . . . . . . .. 103

AIX configuration considerations prior toperforming snapshot-based file backups andarchives . . . . . . . . . . . . . .. 104Configuring NetApp and Tivoli Storage Managerfor snapshot difference incremental backups . .. 105

Protection for clustered-data ONTAP NetAppfile server volumes . . . . . . . . .. 106SnapMirror support for NetAppsnapshot-assisted progressive incrementalbackup (snapdiff) . . . . . . . . . .. 108

Register your workstation with a server . . .. 111Closed registration . . . . . . . . .. 112Open registration . . . . . . . . . .. 112

Creating an include-exclude list . . . . . .. 112Include-exclude options . . . . . . . .. 114

Exclude file spaces and directories . . .. 114Exclude files and directories from ajournal-based backup . . . . . . . .. 115Control processing with exclude statements 115System files to exclude . . . . . . .. 116Include and exclude files that containwildcard characters . . . . . . . .. 117Include and exclude groups of files withwildcard characters . . . . . . . .. 118Examples using wildcards with include andexclude patterns . . . . . . . . .. 119

Symbolic link and alias processing . . . .. 120Determine compression and encryptionprocessing . . . . . . . . . . . .. 121Preview include-exclude list files . . . . .. 122Include and exclude option processing . . .. 122

Chapter 3. Getting started . . . . .. 127Tivoli Storage Manager client authentication . .. 127Starting a Java GUI session . . . . . . . .. 128

Tivoli Storage Manager password . . . .. 129Setup wizard . . . . . . . . . . .. 129

Starting a command-line session . . . . . .. 129Using batch mode . . . . . . . . . .. 130Issuing a series of commands by usinginteractive mode . . . . . . . . . .. 130

Specifying input strings that contain blank spacesor quotation marks . . . . . . . . . .. 131Starting: Additional considerations . . . . .. 131Starting a web client session . . . . . . .. 132

User privileges . . . . . . . . . . .. 132Start the client scheduler automatically . . . .. 133Changing your password . . . . . . . .. 133Sorting file lists using the Tivoli Storage ManagerGUI . . . . . . . . . . . . . . .. 135Displaying online help . . . . . . . . .. 136Ending a session . . . . . . . . . . .. 136Online forums . . . . . . . . . . . .. 137

iv IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide

Chapter 4. Backing up your data . .. 139Planning your backups . . . . . . . . .. 139Which files are backed up . . . . . . . .. 139When to back up and when to archive files . .. 140Pre-backup considerations (UNIX and Linux). .. 141

LAN-free data movement . . . . . . .. 141LAN-free prerequisites . . . . . . .. 141LAN-free data movement options . . .. 141

Incremental backups on memory-constrainedsystems . . . . . . . . . . . . .. 142Incremental backups on systems with a largenumber of files . . . . . . . . . . .. 142Include-exclude options to control processing 144Data encryption during backup or archiveoperations . . . . . . . . . . . .. 144File system and ACL support . . . . . .. 145Maximum file size for operations. . . . .. 148Long user and group names . . . . . .. 149Mac OS X volume names . . . . . . .. 149

Mac OS X volume naming precautions . .. 149Mac OS X volume naming precautions ondual boot systems . . . . . . . . .. 150

Mac OS X Unicode enablement . . . . .. 151Mac OS X Time Machine backup disk . . .. 151

Performing an incremental, selective, orincremental-by-date backup (UNIX and Linux) .. 152

Full and partial incremental backup . . . .. 152Journal-based backup on AIX and Linux .. 154

Incremental-by-date backup . . . . . .. 156Comparing incremental-by-date, journal-based,and NetApp snapshot difference to fullincremental and partial incremental backups .. 156Snapshot differential backup with an HTTPSconnection . . . . . . . . . . . .. 158

Running a snapshot differential backup withan HTTPS connection . . . . . . .. 159

Selective backup . . . . . . . . . .. 159Solaris global zone and non-global zonesbackups . . . . . . . . . . . . .. 160Saving access permissions . . . . . . .. 160Setting a virtual mount point . . . . . .. 160Backing up data using the Java GUI . . . .. 161Backing up data using the command line . .. 162Deleting backup data . . . . . . . . .. 164Deleting file spaces . . . . . . . . .. 165

Backing up files from one or more file spaces for agroup backup (UNIX and Linux) . . . . . .. 166Backing up data with client-node proxy support(UNIX and Linux) . . . . . . . . . . .. 166

Enabling multiple node operations from theGUI . . . . . . . . . . . . . .. 167Setting up encryption . . . . . . . .. 168Scheduling backups with client-node proxysupport . . . . . . . . . . . . .. 168

Examples of how to schedule a backup of anIBM PowerHA SystemMirror cluster. . .. 169Scheduling a backup of a GPFS file system 171

Associate a local snapshot with a server file space(UNIX and Linux) . . . . . . . . . . .. 172Image backup . . . . . . . . . . . .. 172

Performing prerequisite tasks before creating animage backup . . . . . . . . . . .. 173

Volume device type support for an imagebackup . . . . . . . . . . . .. 174

Utilizing image backups to perform file systemincremental backups . . . . . . . . .. 176

Method 1: Using image backups with filesystem incremental backups . . . . .. 176Method 2: Using image backups withincremental-by-date image backups . . .. 177Comparing methods 1 and 2 . . . . .. 178

Performing an image backup using the GUI .. 178Performing an image backup using thecommand line . . . . . . . . . . .. 179

Snapshot-based file backup and archive andsnapshot-based image backup . . . . . . .. 180Protecting Btrfs file systems . . . . . . .. 181

Backing up and restoring Btrfs file systems .. 181Backing up and restoring Btrfs subvolumes .. 183

Back up NAS file systems using Network DataManagement Protocol . . . . . . . . .. 184

Backing up NAS file systems with the webclient GUI using NDMP protocol . . . . .. 185Back up NAS file systems using the commandline. . . . . . . . . . . . . . .. 186

Backup network file systems . . . . . . .. 188Back up NFS file systems with the globalnamespace feature. . . . . . . . . .. 189

Back up AIX workload partition file systems . .. 189Backing up Solaris Zettabyte file systems . . .. 191AIX JFS2 encrypted file system backup . . . .. 191Back up AIX JFS2 extended attributes . . . .. 193Backing up VMware virtual machines . . . .. 193

Preparing the environment for full backups ofVMware virtual machines . . . . . . .. 194Creating full backups for VMware virtualmachines . . . . . . . . . . . . .. 195Parallel backups of virtual machines. . . .. 197

Back up and archive Tivoli Storage ManagerFastBack data . . . . . . . . . . . .. 201Display backup processing status. . . . . .. 202Backup (UNIX and Linux): Additionalconsiderations . . . . . . . . . . . .. 204

Stored files . . . . . . . . . . . .. 204Special file systems . . . . . . . . .. 205NFS or virtual mount points . . . . . .. 206Management classes . . . . . . . . .. 206Back up symbolic links . . . . . . . .. 206

Examples: Incremental or selective backup ofsymbolic links . . . . . . . . . .. 206Incremental backup of a domain only . .. 208

Hard links . . . . . . . . . . . .. 208Sparse files . . . . . . . . . . . .. 209NFS hard and soft mounts . . . . . . .. 209Deleted file systems . . . . . . . . .. 210Opened files. . . . . . . . . . . .. 210Wildcard characters . . . . . . . . .. 211

Chapter 5. Restoring your data . . .. 213Restoring an image . . . . . . . . . .. 213

Restoring an image using the GUI . . . .. 214

Contents v

Restoring an image using the command line .. 216Restore data from a backup set . . . . . .. 216

Restore backup sets: considerations andrestrictions . . . . . . . . . . . .. 218Backup set restore . . . . . . . . . .. 219Restoring backup sets using the GUI . . .. 220Backup set restores using the clientcommand-line interface . . . . . . . .. 221

Restoring or retrieving data during a failover. .. 221Restore an image to file . . . . . . . . .. 223Manage GPFS file system data with storage pools 223Restoring data to a point in time . . . . . .. 225Restore AIX encrypted files. . . . . . . .. 226Restore AIX workload partition file systems . .. 227Restore NAS file systems . . . . . . . .. 228

Restoring NAS file systems using the web client 228Options and commands to restore NAS filesystems from the command line . . . . .. 229

Restore active or inactive backups . . . . .. 230Restoring data using the GUI . . . . . . .. 231Command line restore examples . . . . . .. 231

Examples: Command line restores for largeamounts of data . . . . . . . . . .. 233Standard query restore, no-query restore, andrestartable restore . . . . . . . . . .. 233

Standard query restore process . . . .. 234No-query restore process . . . . . .. 234Restartable restore process . . . . . .. 235

Restoring Solaris Zettabyte (ZFS) file systems .. 235Additional restore tasks . . . . . . . . .. 236

Authorizing another user to restore or retrieveyour files . . . . . . . . . . . . .. 236Restoring or retrieving files from another clientnode . . . . . . . . . . . . . .. 237Restore or retrieve files to another workstation 238Restoring a disk in case of disk loss . . . .. 238Deleting file spaces . . . . . . . . .. 239Enable SELinux to restore files on the Red HatEnterprise Linux 5 client . . . . . . .. 240

Chapter 6. Archive and retrieve yourdata (UNIX and Linux). . . . . . .. 241Archive files. . . . . . . . . . . . .. 241

Archiving data with the GUI . . . . . .. 241Archive data examples by using the commandline. . . . . . . . . . . . . . .. 242

Associate a local snapshot with a server filespace . . . . . . . . . . . . .. 243

Archiving data with client node proxy . . .. 243Deleting archive data . . . . . . . . .. 245Advanced archive tasks . . . . . . . .. 246

Access permissions . . . . . . . .. 246Archive and retrieve symbolic links . . .. 246Hard links . . . . . . . . . . .. 247

Retrieve archives . . . . . . . . . . .. 247Retrieving data with the GUI . . . . . .. 248Retrieve data examples by using the commandline. . . . . . . . . . . . . . .. 248Archive management classes . . . . . .. 249

Chapter 7. Tivoli Storage Managerscheduler overview . . . . . . . .. 251Examples: Blank spaces in file names in scheduledefinitions . . . . . . . . . . . . .. 252Preferential start times for certain nodes . . .. 252Scheduler processing options . . . . . . .. 253

Evaluate schedule return codes in schedulescripts . . . . . . . . . . . . . .. 254Return codes from preschedulecmd andpostschedulecmd scripts . . . . . . . .. 255

Client-acceptor scheduler services versus thetraditional scheduler services . . . . . . .. 256Set the client scheduler process to run as abackground task and start automatically at startup . 256Examples: Display information about scheduledwork . . . . . . . . . . . . . . .. 258Display information about completed work . .. 260Specify scheduling options . . . . . . . .. 261Scheduler options for commands . . . . . .. 261Enable or disable scheduled commands . . .. 261Manage multiple schedule requirements on onesystem . . . . . . . . . . . . . .. 262

Chapter 8. Client return codes . . .. 265

Chapter 9. Storage managementpolicies . . . . . . . . . . . . .. 267Policy domains and policy sets . . . . . .. 267Management classes and copy groups . . . .. 268Display information about management classesand copy groups . . . . . . . . . . .. 269

Copy group name attribute. . . . . . .. 269Copy type attribute . . . . . . . . .. 269Copy frequency attribute . . . . . . .. 270Versions data exists attribute . . . . . .. 270Versions data deleted attribute . . . . .. 270Retain extra versions attribute . . . . . .. 270Retain only version attribute . . . . . .. 270Copy serialization attribute . . . . . . .. 271Copy mode parameter . . . . . . . .. 271Copy destination attribute . . . . . . .. 272Retain versions attribute. . . . . . . .. 272Deduplicate data attribute . . . . . . .. 272

Select a management class for files . . . . .. 272Assign a management class to files . . . . .. 273Override the management class for archived files 274Select a management class for directories . . .. 274Bind management classes to files . . . . . .. 275Rebind backup versions of files . . . . . .. 276Retention grace period . . . . . . . . .. 276Event-based policy retention protection. . . .. 277

Archive files on a data retention server . . .. 277

Chapter 10. Processing options . .. 279Processing options overview . . . . . . .. 279Communication options . . . . . . . . .. 280

TCP/IP options . . . . . . . . . .. 280Shared memory options . . . . . . . .. 281

Server options . . . . . . . . . . . .. 281Backup and archive processing options . . . .. 282

vi IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide

Restore and retrieve processing options. . . .. 291Scheduling options . . . . . . . . . .. 294Format and language options . . . . . . .. 296Command processing options . . . . . . .. 296Authorization options . . . . . . . . .. 297Error processing options. . . . . . . . .. 297Transaction processing options . . . . . .. 298Web client options. . . . . . . . . . .. 298Diagnostics options . . . . . . . . . .. 299Using options with commands . . . . . .. 299

Entering options with a command . . . .. 300Initial command-line-only options . . . .. 305Client options that can be set by the TivoliStorage Manager server . . . . . . . .. 306

Client options reference . . . . . . . . .. 308Absolute . . . . . . . . . . . . .. 308Afmskipuncachedfiles . . . . . . . .. 309Archmc . . . . . . . . . . . . . .. 310Archsymlinkasfile . . . . . . . . .. 310Asnodename . . . . . . . . . . . .. 311Auditlogging . . . . . . . . . . .. 312Auditlogname . . . . . . . . . . .. 314Autodeploy . . . . . . . . . . . .. 316Autofsrename . . . . . . . . . . .. 317Automount . . . . . . . . . . . .. 319Backmc . . . . . . . . . . . . . .. 320Backupsetname . . . . . . . . . . .. 321Basesnapshotname . . . . . . . . . .. 322Changingretries . . . . . . . . . .. 323Class . . . . . . . . . . . . . .. 324Collocatebyfilespec . . . . . . . . .. 324Commmethod . . . . . . . . . . . .. 325Commrestartduration . . . . . . . . .. 327Commrestartinterval . . . . . . . . .. 327Compressalways . . . . . . . . . . .. 328Compression . . . . . . . . . . . .. 329Console . . . . . . . . . . . . .. 330Createnewbase . . . . . . . . . . .. 331Datacenter . . . . . . . . . . . .. 333Datastore . . . . . . . . . . . .. 334Dateformat . . . . . . . . . . . .. 334Dedupcachepath . . . . . . . . . . .. 337Dedupcachesize . . . . . . . . . . .. 338Deduplication . . . . . . . . . . .. 339Defaultserver . . . . . . . . . . .. 340Deletefiles . . . . . . . . . . . .. 340Description . . . . . . . . . . . .. 341Detail . . . . . . . . . . . . . .. 342Diffsnapshot . . . . . . . . . . .. 344Diffsnapshotname . . . . . . . . . .. 345Dirmc . . . . . . . . . . . . . .. 346Dirsonly . . . . . . . . . . . . .. 347Disablenqr . . . . . . . . . . . .. 347Diskbuffsize . . . . . . . . . . .. 348Diskcachelocation . . . . . . . . .. 349Domain . . . . . . . . . . . . . .. 350Domain.image . . . . . . . . . . .. 355Domain.nas . . . . . . . . . . . .. 356Domain.vcd . . . . . . . . . . . .. 357Domain.vmfull . . . . . . . . . . .. 359Dontload . . . . . . . . . . . . .. 364

Dynamicimage . . . . . . . . . . .. 365Efsdecrypt . . . . . . . . . . . .. 366Enablearchiveretentionprotection . . . .. 367Enablededupcache . . . . . . . . . .. 368Enablelanfree . . . . . . . . . . .. 369Encryptiontype . . . . . . . . . . .. 370Encryptkey . . . . . . . . . . . .. 371Errorlogmax . . . . . . . . . . . .. 373Errorlogname . . . . . . . . . . .. 374Errorlogretention . . . . . . . . .. 375Exclude options . . . . . . . . . .. 377

Controlling symbolic link and aliasprocessing . . . . . . . . . . .. 380Controlling compression processing . . .. 380Processing NAS file systems . . . . .. 381Virtual machine exclude options . . . .. 381

Fbbranch . . . . . . . . . . . . .. 383Fbclientname . . . . . . . . . . .. 384Fbpolicyname . . . . . . . . . . .. 385Fbreposlocation . . . . . . . . . .. 386Fbserver . . . . . . . . . . . . .. 388Fbvolumename . . . . . . . . . . .. 389Filelist . . . . . . . . . . . . .. 390Filename . . . . . . . . . . . . .. 393Filesonly . . . . . . . . . . . .. 394Followsymbolic . . . . . . . . . . .. 394Forcefailover . . . . . . . . . . .. 396Fromdate . . . . . . . . . . . . .. 397Fromnode . . . . . . . . . . . . .. 398Fromowner . . . . . . . . . . . .. 398Fromtime . . . . . . . . . . . . .. 399Groupname . . . . . . . . . . . .. 400Groups (deprecated) . . . . . . . . .. 400Guitreeviewafterbackup . . . . . . . .. 401Host . . . . . . . . . . . . . .. 401Httpport . . . . . . . . . . . . .. 401Hsmreparsetag . . . . . . . . . . .. 402Ieobjtype . . . . . . . . . . . .. 403Ifnewer . . . . . . . . . . . . .. 404Imagegapsize . . . . . . . . . . .. 405Imagetofile . . . . . . . . . . . .. 406Inactive . . . . . . . . . . . . .. 407Inclexcl . . . . . . . . . . . . .. 407

Considerations for Unicode-enabled clients 408Include options. . . . . . . . . . .. 409

Controlling symbolic link and aliasprocessing . . . . . . . . . . .. 414Compression and encryption backupprocessing . . . . . . . . . . .. 414Processing NAS file systems . . . . .. 415Virtual machine include options . . . .. 416

Incrbydate . . . . . . . . . . . .. 424Incremental . . . . . . . . . . . .. 425Lanfreecommmethod . . . . . . . . .. 426Lanfreeshmport . . . . . . . . . . .. 427Lanfreetcpport . . . . . . . . . . .. 428Lanfreessl . . . . . . . . . . . .. 429Lanfreetcpserveraddress . . . . . . .. 429Latest . . . . . . . . . . . . . .. 430Localbackupset . . . . . . . . . . .. 431Makesparsefile . . . . . . . . . . .. 431

Contents vii

Managedservices . . . . . . . . . .. 432Maxcmdretries . . . . . . . . . . .. 434Mbobjrefreshthresh . . . . . . . . .. 435Mbpctrefreshthresh . . . . . . . . .. 436Memoryefficientbackup . . . . . . . .. 437Mode . . . . . . . . . . . . . .. 438Monitor . . . . . . . . . . . . .. 442Myreplicationserver . . . . . . . . .. 443Nasnodename . . . . . . . . . . . .. 444Nfstimeout . . . . . . . . . . . .. 445Nodename . . . . . . . . . . . . .. 447Nojournal . . . . . . . . . . . .. 448Noprompt . . . . . . . . . . . . .. 448Nrtablepath . . . . . . . . . . . .. 449Numberformat . . . . . . . . . . .. 450Optfile . . . . . . . . . . . . .. 452Password . . . . . . . . . . . . .. 452Passwordaccess . . . . . . . . . . .. 454Passworddir . . . . . . . . . . . .. 456Pick . . . . . . . . . . . . . .. 457Pitdate . . . . . . . . . . . . .. 458Pittime . . . . . . . . . . . . .. 458Postschedulecmd/Postnschedulecmd . . . .. 459Postsnapshotcmd . . . . . . . . . .. 461Preschedulecmd/Prenschedulecmd . . . .. 462Preservelastaccessdate . . . . . . . .. 464Preservepath . . . . . . . . . . .. 465Presnapshotcmd . . . . . . . . . . .. 467Queryschedperiod . . . . . . . . . .. 469Querysummary . . . . . . . . . . .. 469Quiet . . . . . . . . . . . . . .. 471Quotesareliteral . . . . . . . . . .. 471Removeoperandlimit . . . . . . . . .. 473Replace . . . . . . . . . . . . .. 473Replserverguid . . . . . . . . . . .. 475Replservername . . . . . . . . . . .. 476Replsslport . . . . . . . . . . . .. 478Repltcpport . . . . . . . . . . . .. 480Repltcpserveraddress . . . . . . . .. 481Resourceutilization . . . . . . . . .. 483

Regulating backup and archive sessions .. 484Regulating restore sessions . . . . . .. 484Multiple client session considerations . .. 485

Retryperiod . . . . . . . . . . . .. 485Revokeremoteaccess . . . . . . . . .. 486Schedcmddisabled . . . . . . . . . .. 487Schedcmdexception . . . . . . . . .. 488Schedlogmax . . . . . . . . . . . .. 489Schedlogname . . . . . . . . . . .. 491Schedlogretention . . . . . . . . .. 492Schedmode . . . . . . . . . . . .. 493Schedrestretrdisabled . . . . . . . .. 495Scrolllines . . . . . . . . . . . .. 495Scrollprompt . . . . . . . . . . .. 496Servername . . . . . . . . . . . .. 497Sessioninitiation . . . . . . . . .. 499Shmport . . . . . . . . . . . . .. 500Showmembers . . . . . . . . . . . .. 501Skipacl . . . . . . . . . . . . .. 502Skipaclupdatecheck . . . . . . . . .. 502Snapdiff . . . . . . . . . . . . .. 503

Snapdiffhttps . . . . . . . . . . .. 508Snapshotcachesize . . . . . . . . .. 509Snapshotproviderfs . . . . . . . . .. 510Snapshotproviderimage . . . . . . . .. 511Snapshotroot . . . . . . . . . . .. 512Srvoptsetencryptiondisabled . . . . . .. 514Srvprepostscheddisabled . . . . . . .. 515Srvprepostsnapdisabled . . . . . . . .. 516Ssl . . . . . . . . . . . . . . .. 517Sslfipsmode . . . . . . . . . . . .. 518Sslrequired . . . . . . . . . . . .. 519Ssldisablelegacytls . . . . . . . . .. 520Stagingdirectory . . . . . . . . . .. 521Subdir . . . . . . . . . . . . . .. 522Tapeprompt . . . . . . . . . . . .. 524Tcpadminport . . . . . . . . . . .. 525Tcpbuffsize . . . . . . . . . . . .. 526Tcpcadaddress . . . . . . . . . . .. 527Tcpclientaddress . . . . . . . . . .. 528Tcpclientport . . . . . . . . . . .. 528Tcpnodelay . . . . . . . . . . . .. 529Tcpport . . . . . . . . . . . . .. 530Tcpserveraddress . . . . . . . . . .. 531Tcpwindowsize . . . . . . . . . . .. 531Timeformat . . . . . . . . . . . .. 532Toc . . . . . . . . . . . . . . .. 535Todate . . . . . . . . . . . . . .. 537Totime . . . . . . . . . . . . . .. 537Txnbytelimit . . . . . . . . . . .. 538Type . . . . . . . . . . . . . .. 539Updatectime . . . . . . . . . . . .. 540Useexistingbase . . . . . . . . . .. 541Usereplicationfailover . . . . . . . .. 542Users (deprecated). . . . . . . . . .. 542V2archive . . . . . . . . . . . .. 543Vappmc . . . . . . . . . . . . . .. 544Vcdhost . . . . . . . . . . . . .. 545Vcdpw . . . . . . . . . . . . . .. 545Vcduser . . . . . . . . . . . . .. 546Verbose . . . . . . . . . . . . .. 547Verifyimage . . . . . . . . . . . .. 548Virtualfsname . . . . . . . . . . .. 548Virtualmountpoint . . . . . . . . .. 549Virtualnodename . . . . . . . . . .. 550Vmbackdir . . . . . . . . . . . .. 551Vmbackuptype . . . . . . . . . . .. 552Vmmc . . . . . . . . . . . . . .. 553Vmchost . . . . . . . . . . . . .. 553Vmcpw . . . . . . . . . . . . . .. 554Vmctlmc . . . . . . . . . . . . .. 555Vmcuser . . . . . . . . . . . . .. 556Vmdefaultdvportgroup . . . . . . . .. 557Vmdefaultdvswitch . . . . . . . . .. 558Vmdefaultnetwork . . . . . . . . .. 558Vmenabletemplatebackups . . . . . . .. 559Vmlimitperdatastore . . . . . . . . .. 561Vmlimitperhost . . . . . . . . . . .. 562Vmmaxparallel . . . . . . . . . . .. 563Vmmaxvirtualdisks . . . . . . . . .. 564Vmnoprdmdisks . . . . . . . . . . .. 565Vmnovrdmdisks . . . . . . . . . . .. 566

viii IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide

||

Vmprocessvmwithindependent . . . . . .. 567Vmprocessvmwithprdm . . . . . . . . .. 568Vmskipctlcompression . . . . . . . .. 569Vmskipmaxvirtualdisks . . . . . . . .. 570Vmskipmaxvmdks. . . . . . . . . .. 571Vmverifyifaction . . . . . . . . . .. 572Vmverifyiflatest . . . . . . . . . .. 573Vmvstortransport . . . . . . . . . .. 575Vmtimeout . . . . . . . . . . . .. 576Webports . . . . . . . . . . . . .. 577Wildcardsareliteral . . . . . . . . .. 577

Chapter 11. Using commands . . .. 581Start and end a client command session . . .. 584

Process commands in batch mode . . . .. 584Process commands in interactive mode . . .. 585

Enter client command names, options, andparameters . . . . . . . . . . . . .. 585

Command name . . . . . . . . . .. 586Options . . . . . . . . . . . . .. 586

Options in interactive mode . . . . .. 586Parameters . . . . . . . . . . . .. 586File specification syntax . . . . . . . .. 587

Wildcard characters . . . . . . . . . .. 588Client commands reference . . . . . . . .. 589Archive . . . . . . . . . . . . . .. 589Archive FastBack . . . . . . . . . . .. 592Backup FastBack . . . . . . . . . . .. 594Backup Group . . . . . . . . . . . .. 596Backup Image . . . . . . . . . . . .. 598

Static, dynamic, and snapshot image backup 602Utilizing image backup to perform file systemincremental backup . . . . . . . . .. 602

Backup NAS . . . . . . . . . . . .. 604Backup VAPP . . . . . . . . . . . .. 606Backup VM . . . . . . . . . . . . .. 612Cancel Process . . . . . . . . . . . .. 617Cancel Restore . . . . . . . . . . . .. 618Delete Access . . . . . . . . . . . .. 618Delete Archive . . . . . . . . . . . .. 619Delete Backup . . . . . . . . . . . .. 621Delete Filespace . . . . . . . . . . .. 624Delete Group . . . . . . . . . . . .. 625Expire . . . . . . . . . . . . . . .. 627Help . . . . . . . . . . . . . . .. 628Incremental . . . . . . . . . . . . .. 630

Journal-based backup. . . . . . . . .. 633Incremental-by-Date . . . . . . . . .. 635Associate a local snapshot with a server filespace . . . . . . . . . . . . . .. 636

Loop . . . . . . . . . . . . . . .. 636Macro . . . . . . . . . . . . . . .. 637Monitor Process . . . . . . . . . . .. 638Preview Archive . . . . . . . . . . .. 639Preview Backup . . . . . . . . . . .. 640Query Access . . . . . . . . . . . .. 641Query Archive . . . . . . . . . . . .. 641

Query Backup . . . . . . . . . . . .. 644Query NAS file system images . . . . .. 646

Query Backupset . . . . . . . . . . .. 646Query Backupset without the backupsetnameparameter . . . . . . . . . . . .. 648

Query Filespace . . . . . . . . . . .. 650Query NAS file spaces . . . . . . . .. 651

Query Group . . . . . . . . . . . .. 652Query Image . . . . . . . . . . . .. 653Query Inclexcl . . . . . . . . . . . .. 655Query Mgmtclass . . . . . . . . . . .. 656Query Node. . . . . . . . . . . . .. 657Query Options . . . . . . . . . . . .. 658Query Restore . . . . . . . . . . . .. 659Query Schedule . . . . . . . . . . .. 660Query Session . . . . . . . . . . . .. 660Query Systeminfo . . . . . . . . . .. 661Query VAPP . . . . . . . . . . . .. 663Query VM . . . . . . . . . . . . .. 667Restart Restore . . . . . . . . . . . .. 668Restore . . . . . . . . . . . . . .. 669

Restore from file spaces that are notUnicode-enabled . . . . . . . . . .. 674

Restore Backupset . . . . . . . . . .. 674Restore backup sets: considerations andrestrictions . . . . . . . . . . . .. 677Restore backup sets in a SAN environment .. 678Restore Backupset without the backupsetnameparameter . . . . . . . . . . . .. 678

Restore Group . . . . . . . . . . . .. 681Restore Image . . . . . . . . . . . .. 683Restore NAS . . . . . . . . . . . .. 686Restore VAPP . . . . . . . . . . . .. 688Restore VM . . . . . . . . . . . . .. 691Retrieve . . . . . . . . . . . . . .. 696

Retrieve archives from file spaces that are notUnicode-enabled . . . . . . . . . .. 698

Schedule . . . . . . . . . . . . . .. 698Selective . . . . . . . . . . . . . .. 700

Associate a local snapshot with a server filespace . . . . . . . . . . . . . .. 703

Set Access . . . . . . . . . . . . .. 703Set Event. . . . . . . . . . . . . .. 707Set Netappsvm . . . . . . . . . . .. 709Set Password . . . . . . . . . . . .. 710

Appendix. Accessibility features forthe Tivoli Storage Manager productfamily. . . . . . . . . . . . . .. 717

Notices . . . . . . . . . . . . .. 719

Glossary . . . . . . . . . . . .. 723

Index . . . . . . . . . . . . . .. 725

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 . . . . . . . . . .. 2

2. Default log file location. . . . . . . . .. 33. 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. HP-UX Itanium 2 client: Language codes for

installation packages . . . . . . . .. 1712. Package names, contents, and default directory 2013. Language pack identifiers . . . . . . .. 2314. Package names, contents, and default directory 2415. Package names, contents, and default directory 2716. Package names, contents, and default directory 2817. Language pack identifiers . . . . . . .. 3218. Package names, contents, and default directory 3319. Language pack identifiers . . . . . . .. 3520. Package names, contents, and default directory 3721. Language pack identifiers . . . . . . .. 4022. Installation package names and descriptions 4323. Tasks for root users, authorized users, and

other users . . . . . . . . . . . .. 4724. Mac OS X authorization tools and associated

Tivoli Storage Manager applications . . .. 4925. Client acceptor-managed services versus

traditional scheduler services. . . . . .. 6326. Data deduplication settings: Client and server 8227. Options for excluding file spaces and

directories. . . . . . . . . . . .. 11428. Options for controlling processing using

include and exclude statements . . . .. 11529. Wildcard and other special characters 11830. Using wildcard characters with include and

exclude patterns . . . . . . . . .. 11931. Options for controlling symbolic link and

alias processing . . . . . . . . . .. 12132. Options for controlling compression and

encryption . . . . . . . . . . .. 12133. Working with your files using the Tivoli

Storage Manager GUI . . . . . . . .. 13534. Supported file systems and ACL support 14535. Maximum file size . . . . . . . . .. 14836. Command-line backup examples . . . .. 16237. Volume device-type support for an image

backup. . . . . . . . . . . . .. 17438. Comparing incremental image backup

methods . . . . . . . . . . . .. 178

39. LVM1 and LVM2 image operationcomparisons . . . . . . . . . . .. 179

40. NAS options and commands . . . . .. 18741. Backup and restore capabilities for VMware

virtual machines on Linux platforms . . .. 19342. Client command line informational messages 20243. Backup set GUI restore restrictions . . .. 21744. Backup set command-line restore restrictions 21745. Sample WPAR restore commands with

dsm.opt file . . . . . . . . . . .. 22846. NAS options and commands . . . . .. 22947. Command-line restore examples . . . .. 23248. Command line archive examples . . . .. 24249. Symbolic link management table for archive

and retrieve . . . . . . . . . . .. 24650. Command line examples of retrieving

archives . . . . . . . . . . . .. 24851. Sample classic query schedule output 25952. Sample enhanced query schedule output 26053. Client return codes and their meanings 26554. Default attribute values in the standard

management class . . . . . . . . .. 26955. TCP/IP options . . . . . . . . . .. 28056. Shared memory communication options 28157. Sample client system-options file . . . .. 28258. Backup and archive processing options 28259. Restore and retrieve processing options 29160. Scheduling options. . . . . . . . .. 29461. Format and language options . . . . .. 29662. Command processing options . . . . .. 29663. Authorization options. . . . . . . .. 29764. Error processing options . . . . . . .. 29765. Transaction processing options . . . . .. 29866. Web client options . . . . . . . . .. 29867. Diagnostics options . . . . . . . .. 29968. Client command options . . . . . . .. 30169. Options that are valid on the initial command

line only . . . . . . . . . . . .. 30670. Options that can be set by the Tivoli Storage

Manager server . . . . . . . . . .. 30771. Sample time format settings in the locale

configuration (t_fmt line) . . . . . .. 33772. Sample date format settings in the locale

configuration (d_fmt line) . . . . . .. 33773. Interaction of domain definitions from several

sources. . . . . . . . . . . . .. 35474. Other optional parameters . . . . . .. 41375. Incremental command: Related options 50576. Effects of server and client SSL settings on

success or failure of login attempts . . .. 52077. Sample time format settings in the locale

configuration (t_fmt line) . . . . . .. 53578. Sample date format settings in the locale

configuration (d_fmt line) . . . . . .. 53579. Commands . . . . . . . . . . .. 58180. Wildcard characters . . . . . . . .. 589

© Copyright IBM Corp. 1993, 2015 xi

||||

81. Archive command: Related options . . .. 59182. Archive FastBack command: Related options 59383. Backup FastBack command: Related options 59584. Backup Group command: Related options 59885. Backup Image command: Related options 60086. Backup NAS command: Related options 60587. Backup VAPP command: Related options 60888. Delete Archive command: Related options 62089. Delete Backup command: Related options 62390. Delete Filespace command: Related options 62591. Delete Group command: Related options 62692. Expire command: Related options. . . .. 62893. Incremental command: Related options 63194. Query Archive command: Related options 64295. Query Backup command: Related options 64496. Query Backupset command: Related options 64797. Query Backupset command: Related options 64998. Query Filespace command: Related options 65099. Query Group command: Related options 653

100. Query Image command: Related options 654101. Query Mgmtclass command: Related options 657102. Query Node command: Related options 658103. Query Options command: Related options 659104. Query Systeminfo command: Related options 662105. Query VAPP command: Related options 664106. Query VM command: Related options for

VMware virtual machine queries. . . . .. 667107. Restore command: Related options . . .. 672108. Restore Backupset command: Related options 676109. Restore Group command: Related options 681110. Restore Image command: Related options 684111. Restore NAS command: Related options 687112. Restore VAPP command: Related options 690113. Restore VM command: Related options when

restoring VMware virtual machines . . .. 694114. Retrieve command: Related options . . .. 696115. Schedule command: Related options . . .. 699116. Selective command: Related options . . .. 702

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.Related concepts:“Planning your backups” on page 139“New for Tivoli Storage Manager Version 7.1.4” on page xviiChapter 1, “Installing the Tivoli Storage Manager backup-archive clients,” on page1

Who should read this publicationThis publication provides instructions for a user to install, configure, and use theTivoli Storage Manager client.

© Copyright IBM Corp. 1993, 2015 xiii

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.

To view IBM product documentation, see IBM Knowledge Center.

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 { } Braces

xiv IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide

http://www.ibm.com/support/knowledgecenter

v : Colonv , Commav = Equal Signv - Hyphenv () Parenthesesv . 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

►◄

About this publication xv

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

►◄

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 Tivoli Storage Manager Version 7.1.4

New features and other changes are available in the IBM Tivoli Storage ManagerVersion 7.1.4 backup-archive client.

New and changed information is indicated by a vertical bar (|) to the left of thechange.

Back up VMware virtual machine disks as large as 8 TBUse the new vmmaxvirtualdisks option to set the maximum size of theVMware virtual machine disks (VMDKs) that can be backed up.

For more information, see “Vmmaxvirtualdisks” on page 564.

Updated name for the vmskipmaxvmdks optionThe vmskipmaxvmdks option is renamed vmskipmaxvirtualdisks. Use thisoption to specify how a backup operation processes VMDKs that exceedthe maximum disk size.

For more information, see “Vmskipmaxvirtualdisks” on page 570.

Protect VMware virtual volume datastoresYou can now back up and restore virtual machines that are hosted onVMware virtual volume (vVol) datastores.

For more information, see the datastore parameter in “Restore VM” onpage 691.

Protect IBM Spectrum Scale for Linux on z SystemsIBM Spectrum Scale™ is based on IBM General Parallel File System(GPFS™) technology.

For a complete list of the z Systems that you can protect, see Technote1066436, IBM Linux zSeries Client Requirements.

Protect data on Linux on Power Systems™ (Little Endian)The backup-archive client is now available on Linux distributions that arerunning on IBM Power Systems POWER8® (Little Endian Linux) platforms.

To install the client on Red Hat Enterprise Linux (RHEL) 7.1 and SUSELinux Enterprise Server (SLES) 12 operating systems, see “Installing theTivoli Storage Manager client on Linux on Power Systems (Little Endian)”on page 24.

Related information:“About this publication” on page xiii

© Copyright IBM Corp. 1993, 2015 xvii

https://www.ibm.com/support/docview.wss?uid=swg21066436https://www.ibm.com/support/docview.wss?uid=swg21066436

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.Related concepts:“New for Tivoli Storage Manager Version 7.1.4” on page xvii“Planning your backups” on page 139

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.4 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 in technote 1053218.

For information about upgrading your current AIX® IBM PowerHA®

SystemMirror® setups, see “Migrating legacy AIX IBM PowerHA SystemMirrorsetups” on page 103.

Additional upgrade informationWhen you upgrade a Tivoli Storage Manager client, there is additional informationto consider before you use the new client software.

Be aware of the following information when you upgrade a backup-archive client:v If you are upgrading from a Tivoli Storage Manager Version 7.1.2 or earlier

backup-archive client on the HP-UX, Linux, or Oracle Solaris operating system,you must uninstall any previously installed language packages before youproceed with the upgrade.

v For Mac users, updates to the Mac OS X client contained in Tivoli StorageManager 6.3, or newer versions, require you to consider the following items:– 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-8 encoding enables the use of characters from any language in the

© Copyright IBM Corp. 1993, 2015 1

http://www.ibm.com/support/docview.wss?uid=swg21053218

options files. If your dsm.sys or dsm.opt files were previously encoded asMacRoman (or anything other than UTF-8), open them in an editor likeTextEdit and save them with UTF-8 encoding, and without the .txtextension. Your include-exclude lists can be encoded as either UTF-8 orUTF-16. For more information about using Unicode, see “Considerations forUnicode-enabled clients” on page 408.

– Tivoli Storage Manager server file spaces that were created by Mac OS 9clients cannot be managed by the Mac OS X client that was provided in TivoliStorage Manager V6.3. Use q file node f=d on the server to list files storedfor a node. Any Mac-platform files that do not start with a slash (/) wereprobably created by an older Mac client. You cannot restore or otherwisemanage these files by using the Mac OS X client that is provided in thisrelease. You can manage these files, but you must use a Mac client that isinstalled on a Tivoli Storage Manager V6.2.2 (or older) node.

v For a list of new and changed messages since the previous Tivoli StorageManager release, 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.

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

2 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients: Installation and User's Guide

Table 1. Minimum disk space needed for automatic client deployment (continued)

Operating systems Free disk space required

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. The xxxxrepresents the version, release, modification, and fix pack information for thedeployed backup-archive client.

Table 2. Default log file location.

Operating System Directory

AIX /usr/tivoli/client/IBM_ANR_UNX/Vxxxx/log/

Chapter 1. Installing the Tivoli Storage Manager backup-archive clients 3

Table 2. Default log file location. (continued)

Operating System Directory

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 316

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 Systems 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, see technote 1243309.

AIX client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the AIX platform.



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, seetechnote 1052226.

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.4 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.4: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, seetechnote 1197146.

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 Systems client environmentThis section contains client environment information, Tivoli Storage Manager clientcomponents, and hardware and software requirements for the Linux on PowerSystems client platforms.

Linux on Power Systems client installable componentsThe Tivoli Storage Manager command-line, Java GUI, web backup-archive, andAPI comprise the Linux on Power Systems backup-archive client installablecomponents.

You can install the following components with Tivoli Storage Manager Version7.1.4:



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 clients on Linux on Power SystemsThe Tivoli Storage Manager clients on Linux on Power Systems require a minimumamount of hardware, disk space, memory, and software.

For software and hardware requirements for all supported versions of TivoliStorage Manager clients on Linux on Power Systems, including the most recent fixpacks, seetechnote 1169963.

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.4: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, seetechnote 1052223.

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.4 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.4: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, seetechnote 1066436.

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.4 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.4: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, seetechnote 1053584.

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.4 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, see thefollowing IBM support pages:v For Oracle Solaris SPARC client requirements, see

technote 1052211.v For Oracle Solaris x86_64 client requirements, see technote 1232956.

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=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/. If you do not alreadyhave 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, seethe product information at IBM Tivoli Storage Manager Fastback.

For information about integrating Tivoli Storage Manager and Tivoli StorageManager FastBack, see Integrating Tivoli Storage Manager FastBack and TivoliStorage Manager.

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 93

Installing the backup-archive client from the Tivoli Storage ManagerDVDs

You can install the backup-archive client and its components from Tivoli StorageManager DVDs.


http://www.ibm.com/software/tivoli/products/storage-mgr/product-links.htmlftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/ftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/admincenter/v6r3/http://www.ibm.com/support/knowledgecenter/SS9NU9/http://www.ibm.com/support/knowledgecenter/SSGSG7_6.3.0/com.ibm.itsm.srv.fbint.doc_6.2.0/t_fbint.htmlhttp://www.ibm.com/support/knowledgecenter/SSGSG7_6.3.0/com.ibm.itsm.srv.fbint.doc_6.2.0/t_fbint.html

About this task

To install the backup-archive client from a DVD, you change to the directory thatcontains the installation image for your client operating system and you install thebackup-archive client and its components.

The installation images for AIX, HP-UX, Linux, Mac, and Solaris clients are in thefollowing directories on the DVD:v The AIX backup-archive client installation image is in the /usr/sys/inst.images

directory.v The HP-UX backup-archive client installation image is in the tsmcli/hp11ia64/

directory.v The installation images for the backup-archive client on Linux systems are in the

following DVD directories:– For Linux on Power Systems: linuxPPC– For Linux on Power Systems (Little Endian): linuxPLE– For Ubuntu Linux on Power Systems (Little Endian) (API-only): linuxPLE_DEB– For Linux on x86_64 systems: tsmcli/linux86– For x86_64 Ubuntu systems: tsmcli/linux86_DEB– For Linux on System z: linux390

v The installation images for the backup-archive client on Mac systems are in: macv The installation images for the backup-archive client on Oracle Solaris systems

are in the following DVD directories:– For Solaris on x86_64 systems: tsmcli/solaris_x86– For Solaris on SPARC systems: tsmcli/solaris_sparc

Procedure1. Install the backup-archive clients by starting the installation program from the

appropriate installation image directory.2. Optional: Copy the installation images from the DVD to a server workstation

so that client workstations can mount the server volume and start theinstallation from the server copies.Copy all of the files that are in the DVD installation directory for the clientoperating systems and all of the subdirectories and files that are subordinate toit.

Related concepts:“Install the UNIX and Linux backup-archive clients”

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” on page 13v “Installing the Tivoli Storage Manager HP-UX Itanium 2 client” on page 16


|

|

|

|

|

|

v “Installing the Tivoli Storage Manager backup-archive client on Linux on PowerSystems” on page 20

v “Installing the Tivoli Storage Manager client on Linux on Power Systems (LittleEndian)” on page 24

v “Installing the Tivoli Storage Manager API on Ubuntu Linux on Power Systems(Little Endian)” on page 27

v “Installing the Tivoli Storage Manager Linux x86_64 client” on page 28v “Installing the Tivoli Storage Manager Ubuntu Linux x86_64 client” on page 32v “Installing the Tivoli Storage Manager Linux on System z client” on page 36v “Installing the Tivoli Storage Manager Mac OS X client” on page 40v “Installing the Tivoli Storage Manager Solaris client” on page 42Related concepts:Chapter 2, “Configure the Tivoli Storage Manager client,” on page 47

Installing the Tivoli Storage Manager AIX clientYou can install the Tivoli Storage Manager AIX client from the product DVD, orother installation media.

About this task

In Tivoli Storage Manager Version 7.1.4, a 64-bit version of the AIX client isprovided in the distribution libraries. You cannot upgrade a previously installed32-bit AIX client to new the 64-bit AIX client. If you have a 32-bit client that isinstalled from a previous version of Tivoli Storage Manager, use SMIT to performthe following steps: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 ManagerV7.1.4 distribution libraries, in the following order:1. Install the 64-bit API (tivoli.tsm.client.api.64bit).2. Install the 64-bit client (tivoli.tsm.client.ba.64bit).

If you already have a 64-bit Tivoli Storage Manager V6.3 (or newer) client installed,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, V6.1, or V6.2) you must uninstall the client, language packs,and API. Then, install the new Tivoli Storage Manager API 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.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 that is required for journal-basedbackup.

tivoli.tsm.client.jbb.64bitInstalls the Tivoli Storage Manager journal-based backup component.

Each package is installed in the following default installation directory: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.

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 website, 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.

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.


Procedure1. 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 p

Documents

IBM Tivoli Storage Manager for UNIX and Linux Backup ... · IBM T ivoli Stora ge Mana ger for UNIX and Linux Backup-Archive Clients V ersion 7.1.4 Installa tion and User's Guide IBM