1. Tivoli Storage Manager for UNIX and Linux
®
Version 5.5
Backup-Archive Clients Installation and User’s Guide
SC32-0145-01

3. Tivoli Storage Manager for UNIX and Linux
®
Version 5.5
Backup-Archive Clients Installation and User’s Guide
SC32-0145-01

4. Note
Before using this information and the product it supports, read the general information under “Notices” on page 561.
Edition notice
This edition applies to Version 5.5 of IBM Tivoli Storage Manager (5608-ISM), IBM Tivoli Storage Manager Extended
Edition (5608-ISX), IBM Tivoli Storage Manager for Storage Area Networks (5608-SAN), IBM Tivoli Storage Manager
for Space Management (5608-HSM), and to all subsequent releases and modifications until otherwise indicated in
new editions or technical newsletters.
Order publications through your IBM representative or the IBM branch office serving your locality.
Your feedback is important in helping to provide the most accurate and high-quality information. If you have
comments about this manual or any other IBM Tivoli Storage Manager documentation, see “Contacting customer
support” on page xvi.
© Copyright International Business Machines Corporation 1993, 2007. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

5. Contents
Tables . . . . . . . . . . . . . . . ix Uninstalling the Linux for zSeries client . . . . 39
Installing the Solaris clients . . . . . . . . 40
About this book . . . . . . . . . . . xi Uninstalling the Solaris clients . . . . . . . 45
Who should read this manual . . . . . . . . xi
IBM Tivoli Storage Manager Web site . . . . . xii Chapter 2. Configuring Tivoli Storage
Conventions used in this book . . . . . . . . xii Manager . . . . . . . . . . . . . . 47
Reading syntax diagrams . . . . . . . . . . xii Root and authorized user tasks . . . . . . . . 47
Related publications . . . . . . . . . . . xiv Creating and modifying the client system options
Downloading or ordering publications . . . . xv file (required root user or authorized user task) . . 49
Accessibility . . . . . . . . . . . . . xvi Creating a default client user options file
Contacting customer support . . . . . . . xvi (optional root user or authorized user task) . . . 50
Reporting a problem . . . . . . . . . . xvii Setting options in an options file . . . . . . 51
Internet . . . . . . . . . . . . . . xvii Setting environment variables . . . . . . . . 52
Setting language environment variables . . . . 52
Summary of changes for Tivoli Setting processing environment variables . . . 54
Storage Manager . . . . . . . . . . xix Setting Bourne and Korn shell variables . . . . 55
Setting C shell variables . . . . . . . . . 55
| Technical changes for Version 5.5 - November 2007 xix
Setting API environment variables . . . . . . 56
Technical changes for Version 5.4 - January 2007 . . xxi
Configuring the Web client . . . . . . . . . 56
Technical changes for Version 5.3 - March 2006 xxiii
Configuring the client scheduler . . . . . . . 57
Technical changes for Version 5.3 - October 2005 xxiii
Starting the client scheduler . . . . . . . . . 58
Technical changes for Version 5.3 - December 2004 xxv
Configuring Tivoli Storage Manager client/server
communication across a firewall . . . . . . . 59
Chapter 1. Installing Tivoli Storage | Configuring Tivoli Storage Manager client/server
Manager . . . . . . . . . . . . . . 1 | communication with Secure Socket Layer . . . . 62
| Migrating from earlier versions . . . . . . . . 1 Configuring the journal daemon . . . . . . . 63
| Upgrade path for clients and servers . . . . . 1 | AIX configuration considerations prior to
| Additional migration information . . . . . . 2 | performing snapshot-based file backups and
Client environment requirements . . . . . . . 3 | archives . . . . . . . . . . . . . . . 63
AIX client environment . . . . . . . . . . 3 Registering your workstation with a server
HP-UX Itanium 2 client environment . . . . . 5 (required root user or authorized user task) . . . 64
HP-UX PA-RISC client environment . . . . . 6 Using closed registration . . . . . . . . . 64
| Linux Itanium 2 client environment. . . . . . 7 Using open registration . . . . . . . . . 64
Linux on POWER client environment . . . . . 8 Associating your client node with a host system
Linux x86/x86_64 client environment . . . . . 9 (optional) . . . . . . . . . . . . . . . 65
Linux for zSeries client environment . . . . . 10 Creating an include-exclude list (optional root user
Solaris client environment . . . . . . . . 12 or authorized user task) . . . . . . . . . . 66
z/OS UNIX System Services client environment 13 Using include-exclude options . . . . . . . 67
NDMP support requirements (Extended Edition Controlling symbolic link processing . . . . . 71
only) . . . . . . . . . . . . . . . . 14 Controlling compression and encryption
Client installation media on product CDs . . . . 14 processing . . . . . . . . . . . . . . 72
Installing the backup-archive client . . . . . . 15 Testing an include-exclude list with the Preview
Installing the AIX client . . . . . . . . . 16 command . . . . . . . . . . . . . . 72
Uninstalling the AIX client . . . . . . . . 20 Processing include and exclude options . . . . 73
Installing the HP-UX Itanium 2 client . . . . . 21
Uninstalling the HP-UX Itanium 2 client . . . . 24 Chapter 3. Getting started . . . . . . 77
Installing the HP-UX PA-RISC client . . . . . 25 Tivoli Storage Manager client authentication . . . 77
Uninstalling the HP-UX PA-RISC client . . . . 28 Starting a GUI session . . . . . . . . . . . 78
| Installing the Linux Itanium 2 client . . . . . 29 Using your Tivoli Storage Manager password . . 78
| Uninstalling the Linux Itanium 2 client . . . . 30 Setup wizard . . . . . . . . . . . . . 78
Installing the Linux on POWER client . . . . 31 Starting a command-line session . . . . . . . 78
Uninstalling the Linux on POWER client . . . 33 Using batch mode . . . . . . . . . . . 79
Installing the Linux x86/x86_64 client . . . . 34 Using interactive mode . . . . . . . . . 79
Uninstalling the Linux x86/x86_64 client . . . 36 Starting: Additional considerations . . . . . . 80
Installing the Linux for zSeries client . . . . . 37 Starting a Web client session . . . . . . . . . 80
© Copyright IBM Corp. 1993, 2007 iii

6. Setting user privileges . . . . . . . . . . 82 Backing up NAS file systems using the
Starting the client scheduler automatically . . . . 82 command line . . . . . . . . . . . . 120
Changing your password . . . . . . . . . . 82 | Backing up NFS file systems . . . . . . . . 121
Sorting file lists using the Tivoli Storage Manager | Using NFS with the global namespace feature 122
Java GUI . . . . . . . . . . . . . . . 83 | Backing up AIX workload partition file systems 122
Displaying online help . . . . . . . . . . 84 | Backing up Solaris ZFS file systems . . . . . . 124
Ending a session. . . . . . . . . . . . . 84 | Backing up AIX encrypted files . . . . . . . 124
Online forums . . . . . . . . . . . . . 84 | Backing up AIX JFS2 extended attributes . . . . 126
Other sources of online help . . . . . . . . . 85 Backing up the WebSphere Application Server . . 126
Displaying backup processing status . . . . . 126
Chapter 4. Backing up your data . . . 87 Backup: Additional considerations . . . . . . 128
Planning your backups . . . . . . . . . . 87 Understanding how files are stored . . . . . 128
When to back up and when to archive files . . . . 88 How special file systems are handled . . . . 129
Pre-backup considerations . . . . . . . . . 89 Understanding how files are managed . . . . 129
LAN-free data movement. . . . . . . . . 89 Understanding how symbolic links are handled 129
Configure memory-constrained systems to run Understanding how hard links are handled . . 131
incremental backups . . . . . . . . . . 90 Understanding how sparse files are handled . . 131
Configure systems with large numbers of files to Understanding how NFS hard and soft mounts
run incremental backups . . . . . . . . . 90 are handled . . . . . . . . . . . . . 131
Using an include-exclude options list to control | Understanding how deleted file systems are
processing . . . . . . . . . . . . . . 91 | handled . . . . . . . . . . . . . . 132
Encrypting data during backup or archive Backing up opened files . . . . . . . . . 133
operations . . . . . . . . . . . . . . 92 Using wildcard characters . . . . . . . . 133
File system and ACL support . . . . . . . 92
Maximum file size for operations . . . . . . 94 Chapter 5. Restoring your data . . . . 135
How Tivoli Storage Manager handles long user Restoring an active or inactive backup . . . . . 135
and group names . . . . . . . . . . . 95 Restoring data using the GUI . . . . . . . . 136
Performing an incremental, selective, or Restoring data using the command line . . . . 136
incremental-by-date backup . . . . . . . . . 95 Performing large restore operations . . . . . 137
Full and partial incremental backup . . . . . 95 Standard query restore, no query restore, and
Incremental-by-date backup . . . . . . . . 98 restartable restore . . . . . . . . . . . 138
Comparing full incremental, partial incremental, Performing point-in-time restores . . . . . . . 140
incremental-by-date, and journal-based backups . 99 Restoring an image . . . . . . . . . . . 141
Selective backup . . . . . . . . . . . . 99 Performing an image restore using the GUI . . 142
Solaris global zone and local zones backup . . 100 Performing an image restore using the
Saving access permissions . . . . . . . . 100 command line . . . . . . . . . . . . 143
Setting a virtual mount point . . . . . . . 100 Restoring an image to file . . . . . . . . . 143
Backing up data using the Java GUI . . . . . 100 Restoring data from a backupset . . . . . . . 144
Backing up data using the command line . . . 101 Restoring an entire or partial backupset . . . 144
Deleting backup data . . . . . . . . . . 103 Restoring backupsets using the GUI . . . . . 145
Deleting file spaces . . . . . . . . . . 104 Restoring backupsets using the command-line
Group backup: Backing up files from one or more client . . . . . . . . . . . . . . . 146
file spaces . . . . . . . . . . . . . . 104 | Restoring data to a GPFS file system with multiple
Backup with client-node proxy support. . . . . 105 | storage pools . . . . . . . . . . . . . 146
Enabling multiple node operation from the GUI 106 | Restoring Solaris ZFS file systems . . . . . . 148
Setting up encryption . . . . . . . . . 106 | Restoring AIX encrypted files . . . . . . . . 148
Scheduling with client-node proxy support . . 107 | Restoring AIX workload partition file systems . . 148
Associating a local snapshot with a server file Restoring NAS file systems . . . . . . . . . 150
space . . . . . . . . . . . . . . . . 110 Restoring NAS file systems using the Web client 150
Performing an image backup . . . . . . . . 110 Restoring NAS file systems using the command
Before you perform an image backup . . . . 111 line . . . . . . . . . . . . . . . . 151
Utilizing image backup to perform file system Restoring the WebSphere Application Server . . . 152
incremental backup . . . . . . . . . . 114 Restore: Additional considerations . . . . . . 153
Performing an image backup using the GUI . . 115 Authorizing another user to restore or retrieve
Performing an image backup using the your files . . . . . . . . . . . . . . 153
command line . . . . . . . . . . . . 117 Restoring or retrieving files from another client
| Performing snapshot-based file backup and archive node . . . . . . . . . . . . . . . 154
| and snapshot-based image backup . . . . . . 117 Restore or retrieve files to another workstation 155
Backing up NAS file systems . . . . . . . . 118 Restoring a disk in case of disk loss . . . . . 155
Backing up NAS file systems using the Web Deleting file spaces . . . . . . . . . . 156
client GUI . . . . . . . . . . . . . 119
iv IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

7. Restoring files on the Red Hat Enterprise Linux Restore and retrieve processing options. . . . . 195
4 or 5 client (non-root users) . . . . . . . 157 Scheduling options . . . . . . . . . . . 198
Format options . . . . . . . . . . . . . 200
Chapter 6. Archiving and retrieving Command processing options . . . . . . . . 200
your data . . . . . . . . . . . . . 159 Authorization options . . . . . . . . . . 200
Error processing options . . . . . . . . . . 201
Archiving files . . . . . . . . . . . . . 159
Transaction processing options . . . . . . . 201
Archiving data using the GUI . . . . . . . 159
Web client options . . . . . . . . . . . . 202
Archiving data using the command line . . . 160
Diagnostics options . . . . . . . . . . . 203
Archiving data with client node proxy . . . . 161
Using options with commands . . . . . . . 203
Deleting archive data . . . . . . . . . . 163
Entering options with a command . . . . . 203
Archive: Advanced considerations . . . . . 163
Initial command-line-only options . . . . . 209
Retrieving archives . . . . . . . . . . . 164
Client options reference . . . . . . . . . . 210
Retrieving data using the GUI . . . . . . . 165
Archmc . . . . . . . . . . . . . . . 211
Retrieving data using the command line . . . 165
Archsymlinkasfile . . . . . . . . . . . . 212
Understanding how your archives are managed 166
Asnodename . . . . . . . . . . . . . 213
| Auditlogging . . . . . . . . . . . . . 215
Chapter 7. Automating tasks . . . . . 167 | Auditlogname . . . . . . . . . . . . . 217
Specifying scheduling options . . . . . . . . 167 Automount . . . . . . . . . . . . . . 219
Displaying information about scheduled work . . 167 Backupsetname . . . . . . . . . . . . . 220
Displaying information about completed work . . 169 Changingretries . . . . . . . . . . . . 221
Scheduling options for commands . . . . . . 170 Class . . . . . . . . . . . . . . . . 222
Enabling or disabling scheduled commands . . . 170 Collocatebyfilespec . . . . . . . . . . . 223
Client return codes . . . . . . . . . . . 171 Commmethod . . . . . . . . . . . . . 225
Commrestartduration . . . . . . . . . . . 227
Chapter 8. Understanding storage Commrestartinterval . . . . . . . . . . . 228
management policies . . . . . . . . 173 Compressalways . . . . . . . . . . . . 229
Using policy domains and policy sets . . . . . 173 Compression . . . . . . . . . . . . . 230
Using management classes and copy groups . . . 174 Console . . . . . . . . . . . . . . . 232
Displaying information about management classes Dateformat . . . . . . . . . . . . . . 233
and copy groups . . . . . . . . . . . . 175 Defaultserver . . . . . . . . . . . . . 236
Copy group name . . . . . . . . . . . 176 Deletefiles . . . . . . . . . . . . . . 237
Copy type . . . . . . . . . . . . . 176 Description . . . . . . . . . . . . . . 238
Copy frequency . . . . . . . . . . . 176 Detail . . . . . . . . . . . . . . . . 240
Versions data exists . . . . . . . . . . 176 Dirmc . . . . . . . . . . . . . . . . 241
Versions data deleted . . . . . . . . . . 176 Dirsonly . . . . . . . . . . . . . . . 242
Retain extra versions . . . . . . . . . . 177 | Disablenqr . . . . . . . . . . . . . . 243
Retain only version . . . . . . . . . . 177 Diskbuffsize . . . . . . . . . . . . . . 244
Copy serialization . . . . . . . . . . . 177 Diskcachelocation . . . . . . . . . . . . 245
Copy mode . . . . . . . . . . . . . 178 Domain . . . . . . . . . . . . . . . 247
Copy destination . . . . . . . . . . . 178 Domain.image . . . . . . . . . . . . . 251
Retain versions . . . . . . . . . . . . 178 Domain.nas . . . . . . . . . . . . . . 252
Selecting a management class for files . . . . . 178 | Dynamicimage . . . . . . . . . . . . . 254
Assigning a management class to files . . . . . 179 Editor . . . . . . . . . . . . . . . . 255
Overriding the management class for archived files 180 | Efsdecrypt . . . . . . . . . . . . . . 256
Selecting a management class for directories . . . 180 Enablearchiveretentionprotection . . . . . . . 257
Binding management classes to files . . . . . . 181 Enablelanfree . . . . . . . . . . . . . 259
Rebinding backup versions of files . . . . . . 181 Encryptiontype . . . . . . . . . . . . . 261
Using a retention grace period. . . . . . . . 182 | Encryptkey . . . . . . . . . . . . . . 262
Using event-based policy retention protection . . 182 Errorlogmax . . . . . . . . . . . . . . 264
Archiving files on a data retention server . . . 183 Errorlogname . . . . . . . . . . . . . 265
Errorlogretention . . . . . . . . . . . . 266
Chapter 9. Using processing options 185 Exclude options . . . . . . . . . . . . 268
Filelist . . . . . . . . . . . . . . . . 272
Overview of processing options . . . . . . . 185
Filename . . . . . . . . . . . . . . . 274
Communication options . . . . . . . . . . 185
Filesonly . . . . . . . . . . . . . . . 275
TCP/IP options . . . . . . . . . . . 186
Followsymbolic . . . . . . . . . . . . . 276
Shared memory options . . . . . . . . . 186
Fromdate . . . . . . . . . . . . . . . 277
Server and node options. . . . . . . . . . 187
Fromnode . . . . . . . . . . . . . . 278
Server options . . . . . . . . . . . . 187
Fromowner . . . . . . . . . . . . . . 279
Node options . . . . . . . . . . . . 188
Fromtime . . . . . . . . . . . . . . . 280
Backup and archive processing options . . . . . 188
Contents v

8. Groupname . . . . . . . . . . . . . . 281 Scrolllines . . . . . . . . . . . . . . 364
Groups . . . . . . . . . . . . . . . 282 Scrollprompt . . . . . . . . . . . . . 365
Guitreeviewafterbackup . . . . . . . . . . 283 Servername . . . . . . . . . . . . . . 367
Httpport . . . . . . . . . . . . . . . 284 Sessioninitiation . . . . . . . . . . . . 369
Ifnewer . . . . . . . . . . . . . . . 285 Shmport . . . . . . . . . . . . . . . 371
| Imagegapsize . . . . . . . . . . . . . 286 Showmembers . . . . . . . . . . . . . 372
Imagetofile . . . . . . . . . . . . . . 287 Skipacl . . . . . . . . . . . . . . . 373
Inactive . . . . . . . . . . . . . . . 288 Skipaclupdatecheck . . . . . . . . . . . 374
Inclexcl . . . . . . . . . . . . . . . 289 | Snapshotcachesize . . . . . . . . . . . . 375
Include options . . . . . . . . . . . . . 290 | Snapshotproviderfs . . . . . . . . . . . 377
Processing NAS file systems . . . . . . . . 295 | Snapshotproviderimage . . . . . . . . . . 378
Processing WebSphere Application Server file Snapshotroot . . . . . . . . . . . . . 379
systems . . . . . . . . . . . . . . . 295 Srvprepostscheddisabled . . . . . . . . . 381
Incrbydate . . . . . . . . . . . . . . 296 Srvprepostsnapdisabled . . . . . . . . . . 382
Incremental . . . . . . . . . . . . . . 297 | Ssl . . . . . . . . . . . . . . . . . 383
Lanfreecommmethod . . . . . . . . . . . 298 Subdir . . . . . . . . . . . . . . . . 384
Lanfreeshmport . . . . . . . . . . . . 300 Tapeprompt . . . . . . . . . . . . . . 386
Lanfreetcpport . . . . . . . . . . . . . 301 Tcpadminport . . . . . . . . . . . . . 388
Lanfreetcpserveraddress . . . . . . . . . . 302 Tcpbuffsize . . . . . . . . . . . . . . 389
Latest . . . . . . . . . . . . . . . . 303 Tcpcadaddress . . . . . . . . . . . . . 390
Localbackupset . . . . . . . . . . . . . 304 Tcpclientaddress . . . . . . . . . . . . 391
Location . . . . . . . . . . . . . . . 305 Tcpclientport . . . . . . . . . . . . . 392
Mailprog . . . . . . . . . . . . . . . 306 Tcpnodelay . . . . . . . . . . . . . . 393
Makesparsefile . . . . . . . . . . . . . 307 Tcpport . . . . . . . . . . . . . . . 394
Managedservices . . . . . . . . . . . . 308 Tcpserveraddress . . . . . . . . . . . . 395
Maxcmdretries . . . . . . . . . . . . . 310 Tcpwindowsize . . . . . . . . . . . . . 396
Memoryefficientbackup . . . . . . . . . . 311 Timeformat . . . . . . . . . . . . . . 397
Mode . . . . . . . . . . . . . . . . 313 Toc . . . . . . . . . . . . . . . . . 399
Monitor . . . . . . . . . . . . . . . 315 Todate . . . . . . . . . . . . . . . . 401
Nasnodename . . . . . . . . . . . . . 316 Totime . . . . . . . . . . . . . . . . 402
Nfstimeout . . . . . . . . . . . . . . 317 Txnbytelimit . . . . . . . . . . . . . . 403
Nodename . . . . . . . . . . . . . . 319 Type . . . . . . . . . . . . . . . . 404
Nojournal . . . . . . . . . . . . . . 321 Users . . . . . . . . . . . . . . . . 405
Noprompt . . . . . . . . . . . . . . 322 V2archive . . . . . . . . . . . . . . 406
Numberformat . . . . . . . . . . . . . 323 Verbose . . . . . . . . . . . . . . . 407
Optfile . . . . . . . . . . . . . . . 325 Verifyimage . . . . . . . . . . . . . . 408
Password . . . . . . . . . . . . . . . 326 Virtualfsname . . . . . . . . . . . . . 409
Passwordaccess . . . . . . . . . . . . . 327 Virtualmountpoint . . . . . . . . . . . . 410
Passworddir . . . . . . . . . . . . . . 329 Virtualnodename . . . . . . . . . . . . 412
Pick . . . . . . . . . . . . . . . . 330 Wasexphome . . . . . . . . . . . . . 414
Pitdate . . . . . . . . . . . . . . . 331 Washome . . . . . . . . . . . . . . . 415
Pittime . . . . . . . . . . . . . . . 332 Wasndhome . . . . . . . . . . . . . . 416
Postschedulecmd/Postnschedulecmd . . . . . 333 Wasnode . . . . . . . . . . . . . . . 417
Postsnapshotcmd . . . . . . . . . . . . 335 Wastype . . . . . . . . . . . . . . . 418
Preschedulecmd/Prenschedulecmd . . . . . . 337 Wasuser . . . . . . . . . . . . . . . 419
Preservelastaccessdate . . . . . . . . . . 339 Webports . . . . . . . . . . . . . . . 420
Preservepath . . . . . . . . . . . . . 341
Presnapshotcmd . . . . . . . . . . . . 344 Chapter 10. Using commands . . . . 421
Queryschedperiod . . . . . . . . . . . . 346 Starting and ending a client command session . . 423
Quiet . . . . . . . . . . . . . . . . 347 Process commands in batch mode . . . . . 424
Removeoperandlimit . . . . . . . . . . . 348 Process commands in interactive mode . . . . 424
Replace . . . . . . . . . . . . . . . 349 Entering client commands . . . . . . . . . 425
Resourceutilization . . . . . . . . . . . 351 Command name . . . . . . . . . . . 425
Retryperiod . . . . . . . . . . . . . . 354 Options . . . . . . . . . . . . . . 425
Revokeremoteaccess . . . . . . . . . . . 355 Parameters . . . . . . . . . . . . . 426
Schedcmddisabled . . . . . . . . . . . . 356 File specification syntax . . . . . . . . . 426
Schedlogmax . . . . . . . . . . . . . 357 Remembering previous commands . . . . . . 427
Schedlogname . . . . . . . . . . . . . 358 Using wildcard characters . . . . . . . . . 428
Schedlogretention . . . . . . . . . . . . 359 Entering commands . . . . . . . . . . . 429
Schedmode . . . . . . . . . . . . . . 361 Client commands reference . . . . . . . . . 429
Schedrestretrdisabled . . . . . . . . . . . 363 Archive . . . . . . . . . . . . . . . 430
vi IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

9. Backup Group . . . . . . . . . . . . . 432 Preferential start times for certain nodes . . . 530
Backup Image . . . . . . . . . . . . . 434 Understanding scheduler processing options . . . 531
Backup NAS . . . . . . . . . . . . . 439 Handling return codes from preschedulecmd
Backup WAS . . . . . . . . . . . . . 442 and postschedulecmd scripts . . . . . . . 532
Cancel Process . . . . . . . . . . . . . 444 Using the client acceptor to manage scheduler
Cancel Restore . . . . . . . . . . . . . 445 services versus the traditional scheduler services . 533
Delete Access . . . . . . . . . . . . . 446 Setting the client scheduler process to run as a
Delete Archive . . . . . . . . . . . . . 447 background task and start automatically at boot
Delete Backup . . . . . . . . . . . . . 449 time . . . . . . . . . . . . . . . . 533
Delete Filespace . . . . . . . . . . . . 452 | Changing processing options used by the scheduler
Delete Group . . . . . . . . . . . . . 454 | service. . . . . . . . . . . . . . . . 535
Expire . . . . . . . . . . . . . . . . 456 Managing multiple schedule requirements on one
Help . . . . . . . . . . . . . . . . 458 system . . . . . . . . . . . . . . . 535
Incremental . . . . . . . . . . . . . . 459 Restarting the scheduler process on a remote
Loop . . . . . . . . . . . . . . . . 465 system . . . . . . . . . . . . . . . 537
Macro . . . . . . . . . . . . . . . . 467 Using the scheduler on clustered systems . . . . 538
Monitor Process . . . . . . . . . . . . 468 Troubleshooting the Tivoli Storage Manager
Preview . . . . . . . . . . . . . . . 469 scheduler . . . . . . . . . . . . . . . 539
Query Access . . . . . . . . . . . . . 470 Investigating abnormal scheduled events . . . 539
Query Archive . . . . . . . . . . . . . 471 Checking the server activity log . . . . . . 540
Query Backup . . . . . . . . . . . . . 473 Inspecting the Client Schedule Log . . . . . 540
Querying NAS file system images . . . . . . 475 Understanding the scheduler log . . . . . . 540
Query Backupset . . . . . . . . . . . . 476
Query Filespace . . . . . . . . . . . . 478 | Appendix B. Using the backup-archive
Query Group . . . . . . . . . . . . . 480 | client in a cluster environment . . . . 543
Query Image . . . . . . . . . . . . . 482
| Overview of cluster environments . . . . . . 543
Query Inclexcl . . . . . . . . . . . . . 484
| Active/Active: Pool cluster resources . . . . 543
Query Mgmtclass . . . . . . . . . . . . 485
| Active/Passive: Fault tolerant . . . . . . . 543
Query Node . . . . . . . . . . . . . . 486
| Concurrent access . . . . . . . . . . . 543
Query Options . . . . . . . . . . . . . 487
| Configuring the backup-archive client in a cluster
Query Restore . . . . . . . . . . . . . 488
| environment . . . . . . . . . . . . . . 543
Query Schedule . . . . . . . . . . . . 489
| Enabling the Tivoli Storage Manager Storage Agent
Query Session . . . . . . . . . . . . . 490
| to perform LAN-free Data Movement . . . . . 550
Query Systeminfo . . . . . . . . . . . . 491
| Enabling Tivoli Storage Manager Web client access
Query WAS . . . . . . . . . . . . . . 493
| in a Cluster Environment . . . . . . . . . 551
Restart Restore . . . . . . . . . . . . . 495
| Migrating legacy AIX HACMP setups . . . . . 552
Restore . . . . . . . . . . . . . . . 496
Restore Backupset . . . . . . . . . . . . 500
Restore Group . . . . . . . . . . . . . 504 Appendix C. Journal daemon
Restore Image . . . . . . . . . . . . . 506 configuration . . . . . . . . . . . 555
Restore NAS . . . . . . . . . . . . . 509 JournalSettings stanza . . . . . . . . . . 555
Restore WAS . . . . . . . . . . . . . 511 JournalExcludeList stanza . . . . . . . . . 556
Retrieve . . . . . . . . . . . . . . . 514 JournaledFileSystemSettings stanza . . . . . . 557
Schedule . . . . . . . . . . . . . . . 516 Overriding stanzas . . . . . . . . . . . 559
Selective . . . . . . . . . . . . . . . 518
Set Access . . . . . . . . . . . . . . 521 Notices . . . . . . . . . . . . . . 561
Set Event . . . . . . . . . . . . . . . 523 Trademarks . . . . . . . . . . . . . . 562
Set Password . . . . . . . . . . . . . 525
Set Waspassword . . . . . . . . . . . . 526 Glossary . . . . . . . . . . . . . 565
Appendix A. Using the Tivoli Storage Index . . . . . . . . . . . . . . . 575
Manager central scheduler . . . . . 529
Overview of the Tivoli Storage Manager scheduler 529
Handling spaces in file names in schedule
definitions . . . . . . . . . . . . . 530
Contents vii

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

11. Tables
1. Typographical conventions . . . . . . . xii 38. NAS options and commands . . . . . . 120
2. IBM Tivoli Storage Manager client and server | 39. Network File System (NFS) ACL support 121
publications . . . . . . . . . . . . xiv 40. Client command line informational messages 126
| 3. New options replacing imagetype=dynamic, 41. Symbolic link management table for backup
| snapshot, and static . . . . . . . . . xix and restore . . . . . . . . . . . . 130
4. Optimized option default values xxviii 42. Restore: Primary tasks . . . . . . . . 135
5. Client requirements . . . . . . . . . . 3 43. Command line restore examples . . . . . 137
6. UNIX client installation reference . . . . . 15 | 44. Sample WPAR restore commands with
7. AIX client: Language codes for installation | dsm.opt file . . . . . . . . . . . . 150
packages . . . . . . . . . . . . . 17 45. NAS options and commands . . . . . . 151
8. HP-UX Itanium 2 client: Language codes for 46. Archive and retrieve: Primary tasks . . . . 159
installation packages . . . . . . . . . 21 47. Command line archive examples . . . . . 160
9. Package Names and Directories . . . . . . 25 48. Symbolic link management table for archive
10. HP-UX PA-RISC client: Language codes for and retrieve . . . . . . . . . . . . 164
installation packages . . . . . . . . . 26 49. Command line examples of retrieving
| 11. Client language packages . . . . . . . . 29 archives . . . . . . . . . . . . . 166
12. Linux on POWER client: Language codes for 50. Client return codes and their meanings 171
installation packages . . . . . . . . . 32 51. Default values in the standard management
13. Package Names and Directories . . . . . . 34 class . . . . . . . . . . . . . . 175
14. Linux x86/x86_64 client: Language codes for 52. TCP/IP options . . . . . . . . . . . 186
installation packages . . . . . . . . . 35 53. Shared memory communication options 186
15. Package Names and Directories . . . . . . 37 54. Server and node options . . . . . . . . 188
16. Linux for zSeries client: Language codes for 55. Backup and archive processing options 188
installation packages . . . . . . . . . 38 56. Restore and retrieve processing options 195
17. Installation package names and descriptions 40 57. Scheduling options. . . . . . . . . . 198
18. Tivoli Storage Manager server Installation 58. Format options . . . . . . . . . . . 200
Guides . . . . . . . . . . . . . . 46 59. Command processing options . . . . . . 200
19. Root user, Authorized User, and 60. Authorization options . . . . . . . . . 200
non-Authorized user tasks . . . . . . . 47 61. Error processing options . . . . . . . . 201
20. Supported language locales . . . . . . . 52 62. Transaction processing options . . . . . . 201
21. Platforms and default log directories . . . . 55 63. Web client options . . . . . . . . . . 202
22. GUID commands . . . . . . . . . . 65 64. Diagnostics options . . . . . . . . . 203
23. Options for excluding file spaces and 65. Client command options . . . . . . . . 204
directories . . . . . . . . . . . . . 68 66. Options that are valid on the initial command
24. Options for controlling backup, archive, and line only . . . . . . . . . . . . . 210
image processing . . . . . . . . . . . 68 67. Entering commands . . . . . . . . . 421
25. Wildcard and other special characters . . . . 70 68. Commands . . . . . . . . . . . . 421
26. Using wildcard characters with include and 69. Command recall and edit functions . . . . 428
exclude patterns . . . . . . . . . . . 71 70. Wildcard characters . . . . . . . . . 429
27. Options for controlling symbolic link 71. Archive command: Related options . . . . 430
processing . . . . . . . . . . . . . 72 72. Backup Group command: Related options 433
28. Options for controlling compression and 73. Backup Image command: Related options 437
encryption processing . . . . . . . . . 72 74. Backup NAS command: Related options 440
29. Working with your files using the Tivoli 75. Backup WAS command: Related options 443
Storage Manager GUI . . . . . . . . . 83 76. Delete Archive command: Related options 447
30. Backup: Primary tasks . . . . . . . . . 87 77. Delete Backup command: Related options 449
31. Planning your backups . . . . . . . . . 87 78. Delete Filespace command: Related options 453
32. Supported file systems and ACL support 92 79. Delete Group command: Related options 454
33. Maximum file size . . . . . . . . . . 94 80. Expire command: Related options . . . . . 456
34. Command line backup examples . . . . . 101 81. Incremental command: Related options 462
35. Volume device type support for an image 82. Query Archive command: Related options 471
backup . . . . . . . . . . . . . . 112 83. Query Backup command: Related options 473
36. Comparing incremental image backup 84. Query Backupset command: Related options 476
methods . . . . . . . . . . . . . 115 85. Query Filespace command: Related options 478
37. LVM1 and LVM2 image operation 86. Query Group command: Related options 480
comparisons . . . . . . . . . . . . 116 87. Query Image command: Related options 482
© Copyright IBM Corp. 1993, 2007 ix

12. 88. Query Mgmtclass command: Related options 485 96. Restore Image command: Related options 507
89. Query Node command: Related options 486 97. Restore NAS command: Related options 510
90. Query Options command: Related options 487 98. Restore WAS command: Related options 512
91. Query Systeminfo command: Related options 492 99. Retrieve command: Related options . . . . 514
92. Query WAS command: Related options 493 100. Schedule command: Related options . . . . 516
93. Restore command: Related options . . . . 497 101. Selective command: Related options . . . . 519
94. Restore Backupset command: Related options 501 102. Scheduled client event status codes . . . . 539
95. Restore Group command: Related options 504
x IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

13. About this book
IBM® Tivoli® Storage Manager is a client-server licensed product that provides
storage management services in a multiplatform computer environment. The
backup-archive client program permits users to back up and archive files from
their workstations or file servers to storage, and restore and retrieve backup
versions and archived copies of files to their local workstations.
In addition to the backup-archive client, Tivoli Storage Manager includes the
following components available on a variety of platforms:
v A server program that permits systems to perform either as a backup and archive
server or migration server for distributed workstations and file servers. The
server program also supplies hierarchical storage management (HSM) services.
See “Related publications” on page xiv for available server publications.
v An administrative client program that you can access from a Web browser or the
command line. The program permits a Tivoli Storage Manager administrator to
control and monitor server activities, define storage management policies for
backup, archive and space management services, and set up schedules to
perform those services at regular intervals. For more information about the
Administrative client, see “Related publications” on page xiv for available Tivoli
Storage Manager Administrator’s Reference publications.
v An application program interface (API) that permits you to enhance an existing
application with storage management services. When an application is registered
with a server as a client node, the application can back up, restore, archive, and
retrieve objects from storage. For more information about the Tivoli Storage
Manager API, see IBM Tivoli Storage Manager Using the Application Programming
Interface, SC32-0147.
v A Web backup-archive client that permits an authorized administrator, help desk
person, or end user to perform backup, restore, archive, and retrieve services
using a Web browser on a remote system. See “Starting a Web client session” on
page 80 for more information.
Associated with Tivoli Storage Manager, but sold separately, is the Tivoli Space
Manager client program which was previously a feature of ADSM known as
Hierarchical Storage Manager (HSM). Tivoli Space Manager automatically migrates
eligible files to storage to maintain specific levels of free space on local file systems
and automatically recalls migrated files when they are accessed. It also permits
users to migrate and recall specific files. This client program runs only on AIX®,
HP-UX PA-RISC, Linux® x86/x86_64, Solaris (SPARC), and z/OS® UNIX® System
Services operating systems. See IBM Tivoli Storage Manager for Space Management for
UNIX and Linux User’s Guide for more information.
The terms hierarchical storage management and space management have the same
meaning throughout this publication.
Who should read this manual
This manual provides instructions for an end-user to install, configure, and use the
Tivoli Storage Manager client. For installation information and supported operating
system levels, see Chapter 1, “Installing Tivoli Storage Manager,” on page 1. For
configuration information, see Chapter 2, “Configuring Tivoli Storage Manager,” on
page 47.
© Copyright IBM Corp. 1993, 2007 xi

14. This manual assumes that you are familiar with your workstation, your operating
system, and your basic system administration.
Tivoli Storage Manager tasks that can only be performed by authorized users and
root users are identified by the phrases, authorized user and root user. See “Root
and authorized user tasks” on page 47 for more information about these tasks. An
authorized user is any user running with a real user ID of 0 (root) or a user who
owns the Tivoli Storage Manager executable and whose owner execution
permission bit is set to s. In the following example, the user tivoli is an authorized
user while running dsmc since the dsmc owner execution permission bit is set to s:
-rwsr-xr-x 1 tivoli dsmdev 2880479 Nov 5 13:42 dsmc*
IBM Tivoli Storage Manager Web site
Technical support information and publications are available at the following
address:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
By accessing the Tivoli Storage Manager home page, you can access subjects that
interest you. You can also access current Tivoli Storage Manager product
information.
Conventions used in this book
This book uses the following typographical conventions:
Table 1. Typographical conventions
Example Description
dsmc.nlm A series of lowercase letters with an extension indicates Tivoli
Storage Manager program file names.
archive Boldface type indicates a command that you type at a
workstation, such as a command you type on a command line.
dateformat Boldface italic type indicates a Tivoli Storage Manager option.
The bold type is used to introduce the option, or used in an
example.
Occasionally, file names are entered in boldface italic for
emphasis.
filespec Italicized type indicates either the name of a parameter, a new
term, or a placeholder for information that you provide.
Italics are also used for emphasis in the text.
maxcmdretries Monospaced type represents fragments of a program or
information as it would display on a screen.
plus sign (+) A plus sign between two keys indicates you should press both
keys at the same time.
Reading syntax diagrams
This section describes how to read the syntax diagrams used in this manual. To
read a syntax diagram, follow the path of the line. Read from left to right, and top
to bottom.
v The ─── symbol indicates the beginning of a syntax diagram.
xii IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

15. v The ─── symbol at the end of a line indicates the syntax diagram continues on
the next line.
v The ─── symbol at the beginning of a line indicates 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 variable, can be:
v On the line (required element)
v Above the line (default element)
v Below the line (optional element).
Syntax diagram description Example
Abbreviations:
KEYWOrd
Uppercase letters denote the shortest
acceptable truncation. If an item appears
entirely in uppercase letters, it cannot be
truncated.
You can type the item in any combination of
uppercase or lowercase letters.
In this example, you can enter KEYWO,
KEYWORD, or KEYWOrd.
Symbols: * Asterisk
{} Braces
Enter these symbols exactly as they appear in : Colon
the syntax diagram. , Comma
= Equal Sign
- Hyphen
() Parentheses
. Period
Space
Variables:
KEYWOrd var_name
Italicized lowercase items (var_name) denote
variables.
In this example, you can specify a var_name
when you enter the KEYWORD command.
Repetition:
An arrow returning to the left means you can
repeat the item. repeat
A character or space within the arrow means
,
you must separate repeated items with that
character or space.
repeat
A footnote by the arrow references the
number of times you can repeat the item.
(1)
repeat
Notes:
1 Specify repeat as many as 5 times.
About this book xiii

16. Syntax diagram description Example
Required choices:
A
When two or more items are in a stack and B
one of them is on the line, you must specify C
one item.
In this example, you must choose A, B, or C.
Optional choice:
When an item is below the line, that item is A
optional. In the first example, you can choose
A or nothing at all.
A
When two or more items are in a stack below
B
the line, all of them are optional. In the
C
second example, you can choose A, B, C, or
nothing at all.
Defaults:
A
Defaults are above the line. The default is
selected unless you override it. You can B
override the default by including an option C
from the stack below the line.
In this example, A is the default. You can
override A by choosing B or C. You can also
specify the default explicitly.
Repeatable choices:
A stack of items followed by an arrow
returning to the left means you can select A
more than one item or, in some cases, repeat B
a single item. C
In this example, you can choose any
combination of A, B, or C.
Syntax fragments:
The fragment name
Some diagrams, because of their length, must
fragment the syntax. The fragment name The fragment name:
appears between vertical bars in the diagram.
The expanded fragment appears between A
vertical bars in the diagram after a heading
with the same fragment name. B
C
Related publications
Table 2 lists the IBM Tivoli Storage Manager client and server publications that are
referred to in this manual.
Table 2. IBM Tivoli Storage Manager client and server publications
Publication title Order number
Client publications
IBM Tivoli Storage Manager Messages SC32-0140
xiv IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

17. Table 2. IBM Tivoli Storage Manager client and server publications (continued)
Publication title Order number
IBM Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User’s Guide SC32-0146
IBM Tivoli Storage Manager for NetWare Backup-Archive Clients Installation and User’s Guide SC32-0144
IBM Tivoli Storage Manager for Macintosh Backup-Archive Clients Installation and User’s Guide SC32-0143
IBM Tivoli Storage Manager for Space Management for UNIX and Linux User’s Guide SC32-0148
IBM Tivoli Storage Manager Using the Application Programming Interface SC32-0147
Server publications
IBM Tivoli Storage Manager for AIX Installation Guide SC32-0134
IBM Tivoli Storage Manager for AIX Administrator’s Reference SC32-0123
IBM Tivoli Storage Manager for AIX Administrator’s Guide SC32-0117
IBM Tivoli Storage Manager for AIX Storage Agent User’s Guide SC32-0129
IBM Tivoli Storage Manager for HP-UX Installation Guide SC32-0135
IBM Tivoli Storage Manager for HP-UX Administrator’s Reference SC32-0124
IBM Tivoli Storage Manager for HP-UX Storage Agent User’s Guide SC32-0130
IBM Tivoli Storage Manager for Linux Installation Guide SC32-0136
IBM Tivoli Storage Manager for Linux Administrator’s Reference SC32-0125
IBM Tivoli Storage Manager for Linux Storage Agent User’s Guide SC32-0131
IBM Tivoli Storage Manager for z/OS Installation Guide SC32-0139
IBM Tivoli Storage Manager for z/OS Administrator’s Reference SC32-0128
IBM Tivoli Storage Manager for Sun Solaris Installation Guide SC32-0137
IBM Tivoli Storage Manager for Sun Solaris Administrator’s Reference SC32-0126
IBM Tivoli Storage Manager for Sun Solaris Administrator’s Guide SC32-0120
IBM Tivoli Storage Manager for Sun Solaris Storage Agent User’s Guide SC32-0132
IBM Tivoli Storage Manager for Windows Installation Guide SC32-0138
IBM Tivoli Storage Manager for Windows Administrator’s Guide SC32-0121
IBM Tivoli Storage Manager for Windows Storage Agent User’s Guide SC32-0133
Downloading or ordering publications
All Tivoli publications are available for electronic download or order from the IBM
Publications Center: http://www.ibm.com/shop/publications/order/.
If you have questions or comments regarding Tivoli publications and product
documentation, visit http://www.ibm.com/software/tivoli/contact.html to send
an e-mail.
The International Technical Support Center (ITSC) publishes Redbooks®, which are
books on specialized topics such as using Tivoli Storage Manager to back up
databases. You can order publications through your IBM representative or the IBM
branch office serving your locality. You can also search for and order books of
interest to you at the IBM Redbooks Web site at this address:
http://www.ibm.com/redbooks/
About this book xv

18. Tivoli Field Guides are designed to address specific technical scenarios or concepts
that are often complex to implement or difficult to understand. All completed field
guides are available free to registered customers and internal IBM employees at the
following Web site:
http://www.ibm.com/software/sysmgmt/products/support/Field_Guides.html
Accessibility
Accessibility features help users with a physical disability, such as restricted
mobility or limited vision, to use software products successfully. With this product,
you can use assistive technologies to hear and navigate the interface. You can also
use the keyboard instead of the mouse to operate all features of the graphical user
interface.
Contacting customer support
For support for this or any Tivoli product, you can contact Tivoli Customer
Support in one of the following ways:
v Through the IBM Support Assistant
An IBM Support Assistant plugin is available for the Tivoli Storage Manager
client to help you to do the following:
– Locate specific self-help information on the Web based of frequently asked
questions and common problems
– Search for other Tivoli Storage Manager information on the Web
– Report a problem
– Automatically collect basic operating system and Tivoli Storage Manager
related environmental and diagnostic information
You can find more information about the IBM Support Assistant at
http://www.ibm.com/software/support/isa. You can also download the IBM
Support Assistant from this page.
v Visit the Tivoli Storage Manager technical support Web site at:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
v Visit the IBM Software Support Toolbar Web site at:
http://www.ibm.com/software/support/toolbar/
v Submit a problem management record (PMR) electronically at
IBMSERV/IBMLINK. You can access from the IBM Web site at:
http://www.ibm.com/ibmlink/
v Submit a problem management record (PMR) electronically from the IBM Web
site at:
http://www.ibm.com/software/support/probsub.html.
Customers in the United States can also call 1-800-IBM-SERV (1-800-426-7378).
International customers should consult the Web site for customer support
telephone numbers.
You can also review the IBM Software Support Guide, which is available on our Web
site at http://techsupport.services.ibm.com/guides/handbook.html.
When you contact IBM Software Support, be prepared to provide identification
information for your company so that support personnel can readily assist you.
Company identification information is needed to register for online support
available on the Web site.
xvi IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

19. The support Web site offers extensive information, including a guide to support
services (IBM Software Support Guide); frequently asked questions (FAQs); and
documentation for all IBM Software products, including Release Notes, Redbooks,
and white papers, defects (APARs), and solutions. The documentation for some
product releases is available in both PDF and HTML formats. Translated
documents are also available for some product releases.
We are very interested in hearing about your experience with Tivoli products and
documentation. We also welcome your suggestions for improvements. If you have
comments or suggestions about our documentation, complete our customer
feedback survey at the following website, by selecting the Feedback link in the left
navigation bar:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
Reporting a problem
Have the following information ready when you report a problem:
v The Tivoli Storage Manager server version, release, modification, and service
level number. You can get this information by entering the query status
command at the Tivoli Storage Manager administrative command line.
v It is recommended that you use the Tivoli Storage Manager client query
systeminfo command with the filename option to gather Tivoli Storage Manager
system information and output this information to a file. This information is
intended primarily as an aid for IBM support to assist in diagnosing problems.
v The Tivoli Storage Manager client version, release, modification, and service
level number. You can get this information by entering dsmc at the command
line.
v The communication protocol (for example, TCP/IP), version, and release number
you are using.
v The activity you were doing when the problem occurred, listing the steps you
followed before the problem occurred.
v The exact text of any error messages.
Internet
To search multiple Internet resources for your product, go to the support web site
for the product:
v http://www.ibm.com/software/sysmgmt/products/support/
IBMTivoliStorageManager.html
and look for the section to search the support knowledge base. From this section,
you can search a variety of resources including:
v IBM technotes
v IBM downloads
v IBM Redbooks
v Forums and newsgroups
You can also check the following IBM Software Support Toolbar Web site, and
choose Tivoli ─> Tivoli developerWorks® ─> Forums. http://www.ibm.com/
software/support/toolbar/
A newsgroup, listserv@marist.edu, is implemented by a third party. IBM supports
this newsgroup on a best-effort basis only. See “Online forums” on page 84 for
more information.
About this book xvii

20. xviii IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

21. Summary of changes for Tivoli Storage Manager
This section summarizes changes made to the Tivoli Storage Manager product and
this publication. Technical changes to the text are indicated by vertical lines to the
left of the change.
| Technical changes for Version 5.5 - November 2007
| The following changes have been made to the product for this edition:
| Transparent encryption support
| Support has been added for transparent encryption, using the
| encryptkeygenerate option. Refer to “Encryptkey” on page 262 for more
| information about this option.
| Secure socket layer (SSL) support
| Support has been added for Secure socket layer (SSL), which allows secure
| communications between the Tivoli Storage Manager client and server.
| Refer to “Configuring Tivoli Storage Manager client/server communication
| with Secure Socket Layer” on page 62 and “Ssl” on page 383 for more
| information.
| TCP/IP Version 6 support
| The IBM Tivoli Storage Manager client now supports the TCP/IP Version 6
| (IPv6) protocol and can be used in a dedicated IPv6, IPv4, or intermixed IP
| environment.
| Auditlogging and auditlogname options
| The auditlogging option generates an audit log with an entry for each file
| that is processed during an incremental, selective, archive, restore, or
| retrieve operation. Refer to “Auditlogging” on page 215 for more
| information about this option.
| The auditlogname option specifies the path and file name where you want
| to store audit log information. This option applies when audit logging is
| enabled. Refer to “Auditlogname” on page 217 for more information about
| this option.
| AIX JFS2 snapshot integration for snapshot-based image backup and
| snapshot-based file level backup and archive
| Snapshot-based image backup and file backup and archive support is
| available for AIX 5.3 or later JFS2 file systems. This support provides
| consistent backup of the files and snapshot-based images.
| The imagetype=dynamic, snapshot, and static options have been replaced by
| the dynamicimage and snapshotproviderimage options as shown in Table 3.
| Table 3. New options replacing imagetype=dynamic, snapshot, and static
| Old option Old option value New option New option value
| imagetype dynamic dynamicimage yes
| imagetype snapshot snapshotproviderimage JFS2 (AIX)
| LINUX_LVM
| imagetype static snapshotproviderimage none
|
| See the following sections for information about using these new options:
© Copyright IBM Corp. 1993, 2007 xix

22. | v “AIX configuration considerations prior to performing snapshot-based
| file backups and archives” on page 63
| v “Performing snapshot-based file backup and archive and snapshot-based
| image backup” on page 117
| v “Dynamicimage” on page 254
| v “Snapshotproviderfs” on page 377
| v “Snapshotproviderimage” on page 378
| AIX JFS2 extended attributes (EA) support
| Support has been added for backing up and restoring AIX JFS2 extended
| attributes (EA) on AIX 5.3 and subsequent releases.
| NFS V4 ACL support on AIX
| NFSV4 ACLs are supported for the AIX JFS2, GPFS, and NFS file systems
| by the Tivoli Storage Manager Backup-Archive client for AIX. Refer to “File
| system and ACL support” on page 92 and “Backing up NFS file systems”
| on page 121 for more information about this support.
| Support for AIX Encrypted File System (EFS)
| Support has been added to allow backup and restore of AIX 6.1 EFS files
| either in clear text or raw format. The efsdecrypt option allows you to
| control whether encrypted files are read in encrypted or decrypted format.
| Refer to “Efsdecrypt” on page 256 for more information.
| AIX workload partition (WPAR) support
| You can install and configure the Tivoli Storage Manager AIX Version 5.5
| client in the global WPAR, using either the INSTALLP or SMIT commands.
| You can back up and restore local workload partition file data from within
| the global partition.
| Installation within the AIX WPAR is not supported. Refer to “Backing up
| AIX workload partition file systems” on page 122 for more information.
| Solaris ZFS support
| Zettabyte file systems (ZFS) are supported for the Solaris SPARC and x86
| clients. This support eliminates the possibility of data being overwritten, or
| that the file system is corrupted through accidental loss of power or a
| system crash. For more information about this support, see “Backing up
| Solaris ZFS file systems” on page 124 and “Restoring Solaris ZFS file
| systems” on page 148.
| Linux Itanium 2 support
| Support has been added for the Linux Itanium 2 client. See “Linux Itanium
| 2 client environment” on page 7 and “Installing the Linux Itanium 2 client”
| on page 29 for more information.
| Red Hat Enterprise Linux 5.0 support
| Red Hat Enterprise Linux 5.0 is now supported on the Linux x86/x86_64,
| Linux for zSeries, Linux on POWER and Linux Itanium 2 clients.
| AIX 6.1 support
| Beginning with this release of Tivoli Storage Manager, AIX 6.1 is
| supported.
| Imagegapsize option
| For AIX JFS2 file systems, the amount of data backed up to Tivoli Storage
| Manager Server during static or snapshot image backup will be reduced by
| backing up only those blocks used by the file system or smaller than the
| imagegapsize option, improving the performance of image backup. The
xx IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

23. | imagegapsize option specifies the minimum size of empty regions on a
| volume that you want to skip during image backup. See “Imagegapsize”
| on page 286 for more information.
| Dropped support for AIX Version 5.2
| Beginning with this release of Tivoli Storage Manager, AIX Version 5.2 is
| no longer supported.
| Clusternode option will be phased out
| The clusternode option is still available for migration to Tivoli Storage
| Manager Version 5.5, but it will be removed in the next release. The
| clusternode option is supported for the HACMP releases supported in this
| release. This option will not be supported for any new HACMP release
| that is not supported by Tivoli Storage Manager Version 5.5. Instead, refer
| to the alternative procedure described in Appendix B, “Using the
| backup-archive client in a cluster environment,” on page 543.
Technical changes for Version 5.4 - January 2007
The following changes have been made to the product for this edition:
Password file format changes
The format of the Tivoli Storage Manager password file has changed. Your
existing password file will be migrated to the new format during the first
session with a Tivoli Storage Manager server after you install the client.
See “Upgrade path for clients and servers” on page 1 for more information
about the changes.
AIX journal support for AIX clients
AIX journal now supports JFS, JFS2, and VxFs and HSM-managed JFS2 file
systems and the HACMP environment.
Linux LVM 2 volume manager image backup support
Image backup of volumes created using the Linux LVM 2 volume manager
is now supported. This provides the same level of functionality as offered
for LVM 1 logical volumes. Only specific Linux distributions (Kernel 2.6)
are supported.
SLES 10 support on Linux clients
SuSE Linux Enterprise Server 10 is now supported on the Linux
x86/x86_64, Linux for zSeries, and Linux PPC clients.
USS V1R7 and V1R8 support
UNIX System Services V1R7 and V1R8 are now supported.
HACMP 5.4 support
HACMP 5.4 is now supported with the AIX Backup-Archive client and
API, if the fix for IY89869 is applied first.
Asianux 2.0 support on Linux x86/x86_64 clients
Asianux 2.0 now supports the Linux x86/x86_64 clients.
Support for srvprepostscheddisabled, srvrprepostsnapdisabled, and schedrestretrdisabled
options
Three new options: srvprepostscheddisabled, srvprepostssnapdisabled, and
schedrestretrdisabled, are now supported, in addition to the existing
schedcmddisabled option. These options help to prevent Tivoli Storage
Manager administrators from executing inadvertent or malicious
operations on Tivoli Storage Manager client nodes.
Summary of changes for Tivoli Storage Manager xxi

24. See “Srvprepostscheddisabled” on page 381, “Srvprepostsnapdisabled” on
page 382, and “Schedrestretrdisabled” on page 363 for information about
these new options.
Reducing the memory used during the incremental backup function
The memoryefficient diskcachemethod option uses local disk space, which
reduces the amount of memory required to complete an incremental
backup. See “Memoryefficientbackup” on page 311 for more information
about using memoryefficient diskcachemethod.
The diskcachelocation option specifies the location where the disk cache
database will be created if the option memoryefficientbackup=diskcachem
is set during an incremental backup. See “Diskcachelocation” on page 245
for information about how to use this option.
Support for include.fs
The include.fs option controls how Tivoli Storage Manager processes your
file space for incremental backup. See “Include options” on page 290 for
more information about using the include.fs option.
Tivoli Storage Manager client support for Novell Storage Services file system
extended attributes
The Tivoli Storage Manager Linux x86/x86_64 client can now back up and
restore Novell Storage Services file system extended attributes. Novell
Storage Services file system Trustee rights are packaged as part of the
extended attributes, and they are also backed up and restored. The
extended attributes information is automatically backed up with each
object that has extended attribute data.
Be aware that the first incremental backup using this client will back up all
Novell Storage Services files again, whether or not they have extended
attributes.
Storage pools on GPFS file systems are supported
Tivoli Storage Manager now handles storage pools on GPFS file systems.
See “Restoring data to a GPFS file system with multiple storage pools” on
page 146 for more information.
Local zone support for Solaris 10 x86 client
Local zone support has been added for the Solaris 10 x86 client. See
“Solaris global zone and local zones backup” on page 100 for more
information.
Dropped support for HP-UX 11i V1
Beginning with this release of Tivoli Storage Manager, HP-UX 11i V1 is no
longer supported.
Dropped support for RHEL 3
Beginning with this release of Tivoli Storage Manager, Red Hat Enterprise
Linux 3 is no longer available.
Dropped support for SLES 8
Beginning with this release of Tivoli Storage Manager, SuSE Linux
Enterprise Server 8 is no longer supported.
Dropped support for AIX Version 5.1
Beginning with this release of Tivoli Storage Manager, AIX Version 5.1 is
no longer supported.
Dropped support for Solaris 8
Beginning with this release of Tivoli Storage Manager, Solaris 8 is no
longer supported.
xxii IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide

25. Dropped support USS V1R4, V1R5, and V1R6
Beginning with this release of Tivoli Storage Manager, UNIX System
Services V1R4, V1R5, and V1R6 are no longer supported.
Technical changes for Version 5.3 - March 2006
The following changes have been made to the product for this edition:
New options, Skipacl and Skipaclupdatecheck
Skipacl and Skipaclupdatecheck are new options for controlling the
processing of access control lists (ACL) by Tivoli Storage Manager.
Skipacl=yes skips ACL processing completely on backup.
Skipaclupdatecheck=yes prevents the Tivoli Storage Manager client from
performing checksum and size comparisons before and after backup, and
during incremental processing. See “Skipacl” on page 373 and
“Skipaclupdatecheck” on page 374 for more information.
Journal-based backup enhancements for AIX
Journal-based backup is supported for non-HSM AIX clients. See
“Configuring the journal daemon” on page 63, “Journal-based backup on
AIX” on page 97, and Chapter 10, “Using commands,” on page 421 for
more information.
Zones support for Solaris 10 platforms
Zones support has been added for the following Solaris 10 platforms:
v Solaris 10 x86 32-bit and 64-bit limited support (Global Zone only, API
32-bit only, UFS only, TCP-IP only, no LAN-Free)
v Solaris 10 SPARC Local Zones
v Solaris 10 SPARC support for Space Management (HSM) (Global Zone
only)
v Solaris HSM requires Veritas File system (VxFS) 4.1
The standard backup and archive operations can be performed from each
Local Zone, just as these operations can be performed on any Solaris
system without zoning.
HP-UX 11i V2 support
HP-UX 11i V2 is supported on the Backup-Archive clients.
Java GUI command-line parameters
Tivoli Storage Manager Backup-Archive Java GUI (dsmj) now accepts
command-line parameters, such as the Java -X options. Because of this, you
can also now modify the Java Heap Size.
Technical changes for Version 5.3 - October 2005
The following changes have been made to the product for this edition:
Event-based policy retention protection
In addition to traditional backup archive processing to a Tivoli Storage
Manager server, the Tivoli Storage Manager Backup-Archive Clients can
now archive data to an IBM System Storage Archive Manager server by
using the enablearchiveretentionprotection option. When connected to any
Tivoli Storage Manager server Version 5.2.2 and above, the Tivoli Storage
Manager Backup-Archive Clients can take advantage of event-based
archive management policies. With the new set event command the client
can also signal events and request deletion hold and deletion release for
specific files. This feature is intended to help customers meet regulatory
Summary of changes for Tivoli Storage Manager xxiii