Your SlideShare is downloading. ×
  • Like
Ibm tivoli storage manager for unix and linux backup archive client installation and user's guide version 5.5 - ans50000
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Now you can save presentations on your phone or tablet

Available for both IPhone and Android

Text the download link to your phone

Standard text messaging rates apply

Ibm tivoli storage manager for unix and linux backup archive client installation and user's guide version 5.5 - ans50000

  • 7,142 views
Published

 

Published in Technology
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads

Views

Total Views
7,142
On SlideShare
0
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
13
Comments
0
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 1. Tivoli Storage Manager for UNIX and Linux ®Version 5.5Backup-Archive Clients Installation and User’s Guide SC32-0145-01
  • 2. Tivoli Storage Manager for UNIX and Linux ®Version 5.5Backup-Archive Clients Installation and User’s Guide SC32-0145-01
  • 3. Note Before using this information and the product it supports, read the general information under “Notices” on page 561.Edition noticeThis edition applies to Version 5.5 of IBM Tivoli Storage Manager (5608-ISM), IBM Tivoli Storage Manager ExtendedEdition (5608-ISX), IBM Tivoli Storage Manager for Storage Area Networks (5608-SAN), IBM Tivoli Storage Managerfor Space Management (5608-HSM), and to all subsequent releases and modifications until otherwise indicated innew 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 havecomments about this manual or any other IBM Tivoli Storage Manager documentation, see “Contacting customersupport” 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 Contractwith IBM Corp.
  • 4. 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
  • 5. 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
  • 6. 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 . . . . . . . . . . . . . 200Chapter 6. Archiving and retrieving Command processing options . . . . . . . . 200your data . . . . . . . . . . . . . 159 Authorization options . . . . . . . . . . 200 Error processing options . . . . . . . . . . 201Archiving 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 . . . . . 209Retrieving 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 . . . . . . . . . . . . . 215Chapter 7. Automating tasks . . . . . 167 | Auditlogname . . . . . . . . . . . . . 217Specifying scheduling options . . . . . . . . 167 Automount . . . . . . . . . . . . . . 219Displaying information about scheduled work . . 167 Backupsetname . . . . . . . . . . . . . 220Displaying information about completed work . . 169 Changingretries . . . . . . . . . . . . 221Scheduling options for commands . . . . . . 170 Class . . . . . . . . . . . . . . . . 222Enabling or disabling scheduled commands . . . 170 Collocatebyfilespec . . . . . . . . . . . 223Client return codes . . . . . . . . . . . 171 Commmethod . . . . . . . . . . . . . 225 Commrestartduration . . . . . . . . . . . 227Chapter 8. Understanding storage Commrestartinterval . . . . . . . . . . . 228management policies . . . . . . . . 173 Compressalways . . . . . . . . . . . . 229Using policy domains and policy sets . . . . . 173 Compression . . . . . . . . . . . . . 230Using management classes and copy groups . . . 174 Console . . . . . . . . . . . . . . . 232Displaying information about management classes Dateformat . . . . . . . . . . . . . . 233and 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 . . . . . . . . . . . . . . 252Selecting a management class for files . . . . . 178 | Dynamicimage . . . . . . . . . . . . . 254Assigning a management class to files . . . . . 179 Editor . . . . . . . . . . . . . . . . 255Overriding the management class for archived files 180 | Efsdecrypt . . . . . . . . . . . . . . 256Selecting a management class for directories . . . 180 Enablearchiveretentionprotection . . . . . . . 257Binding management classes to files . . . . . . 181 Enablelanfree . . . . . . . . . . . . . 259Rebinding backup versions of files . . . . . . 181 Encryptiontype . . . . . . . . . . . . . 261Using a retention grace period. . . . . . . . 182 | Encryptkey . . . . . . . . . . . . . . 262Using event-based policy retention protection . . 182 Errorlogmax . . . . . . . . . . . . . . 264 Archiving files on a data retention server . . . 183 Errorlogname . . . . . . . . . . . . . 265 Errorlogretention . . . . . . . . . . . . 266Chapter 9. Using processing options 185 Exclude options . . . . . . . . . . . . 268 Filelist . . . . . . . . . . . . . . . . 272Overview of processing options . . . . . . . 185 Filename . . . . . . . . . . . . . . . 274Communication options . . . . . . . . . . 185 Filesonly . . . . . . . . . . . . . . . 275 TCP/IP options . . . . . . . . . . . 186 Followsymbolic . . . . . . . . . . . . . 276 Shared memory options . . . . . . . . . 186 Fromdate . . . . . . . . . . . . . . . 277Server and node options. . . . . . . . . . 187 Fromnode . . . . . . . . . . . . . . 278 Server options . . . . . . . . . . . . 187 Fromowner . . . . . . . . . . . . . . 279 Node options . . . . . . . . . . . . 188 Fromtime . . . . . . . . . . . . . . . 280Backup and archive processing options . . . . . 188 Contents v
  • 7. 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
  • 8. Backup Group . . . . . . . . . . . . . 432 Preferential start times for certain nodes . . . 530Backup Image . . . . . . . . . . . . . 434 Understanding scheduler processing options . . . 531Backup NAS . . . . . . . . . . . . . 439 Handling return codes from preschedulecmdBackup WAS . . . . . . . . . . . . . 442 and postschedulecmd scripts . . . . . . . 532Cancel Process . . . . . . . . . . . . . 444 Using the client acceptor to manage schedulerCancel Restore . . . . . . . . . . . . . 445 services versus the traditional scheduler services . 533Delete Access . . . . . . . . . . . . . 446 Setting the client scheduler process to run as aDelete Archive . . . . . . . . . . . . . 447 background task and start automatically at bootDelete Backup . . . . . . . . . . . . . 449 time . . . . . . . . . . . . . . . . 533Delete Filespace . . . . . . . . . . . . 452 | Changing processing options used by the schedulerDelete Group . . . . . . . . . . . . . 454 | service. . . . . . . . . . . . . . . . 535Expire . . . . . . . . . . . . . . . . 456 Managing multiple schedule requirements on oneHelp . . . . . . . . . . . . . . . . 458 system . . . . . . . . . . . . . . . 535Incremental . . . . . . . . . . . . . . 459 Restarting the scheduler process on a remoteLoop . . . . . . . . . . . . . . . . 465 system . . . . . . . . . . . . . . . 537Macro . . . . . . . . . . . . . . . . 467 Using the scheduler on clustered systems . . . . 538Monitor Process . . . . . . . . . . . . 468 Troubleshooting the Tivoli Storage ManagerPreview . . . . . . . . . . . . . . . 469 scheduler . . . . . . . . . . . . . . . 539Query Access . . . . . . . . . . . . . 470 Investigating abnormal scheduled events . . . 539Query Archive . . . . . . . . . . . . . 471 Checking the server activity log . . . . . . 540Query Backup . . . . . . . . . . . . . 473 Inspecting the Client Schedule Log . . . . . 540Querying NAS file system images . . . . . . 475 Understanding the scheduler log . . . . . . 540Query Backupset . . . . . . . . . . . . 476Query Filespace . . . . . . . . . . . . 478 | Appendix B. Using the backup-archiveQuery Group . . . . . . . . . . . . . 480 | client in a cluster environment . . . . 543Query Image . . . . . . . . . . . . . 482 | Overview of cluster environments . . . . . . 543Query Inclexcl . . . . . . . . . . . . . 484 | Active/Active: Pool cluster resources . . . . 543Query Mgmtclass . . . . . . . . . . . . 485 | Active/Passive: Fault tolerant . . . . . . . 543Query Node . . . . . . . . . . . . . . 486 | Concurrent access . . . . . . . . . . . 543Query Options . . . . . . . . . . . . . 487 | Configuring the backup-archive client in a clusterQuery Restore . . . . . . . . . . . . . 488 | environment . . . . . . . . . . . . . . 543Query Schedule . . . . . . . . . . . . 489 | Enabling the Tivoli Storage Manager Storage AgentQuery Session . . . . . . . . . . . . . 490 | to perform LAN-free Data Movement . . . . . 550Query Systeminfo . . . . . . . . . . . . 491 | Enabling Tivoli Storage Manager Web client accessQuery WAS . . . . . . . . . . . . . . 493 | in a Cluster Environment . . . . . . . . . 551Restart Restore . . . . . . . . . . . . . 495 | Migrating legacy AIX HACMP setups . . . . . 552Restore . . . . . . . . . . . . . . . 496Restore Backupset . . . . . . . . . . . . 500Restore Group . . . . . . . . . . . . . 504 Appendix C. Journal daemonRestore Image . . . . . . . . . . . . . 506 configuration . . . . . . . . . . . 555Restore NAS . . . . . . . . . . . . . 509 JournalSettings stanza . . . . . . . . . . 555Restore WAS . . . . . . . . . . . . . 511 JournalExcludeList stanza . . . . . . . . . 556Retrieve . . . . . . . . . . . . . . . 514 JournaledFileSystemSettings stanza . . . . . . 557Schedule . . . . . . . . . . . . . . . 516 Overriding stanzas . . . . . . . . . . . 559Selective . . . . . . . . . . . . . . . 518Set Access . . . . . . . . . . . . . . 521 Notices . . . . . . . . . . . . . . 561Set Event . . . . . . . . . . . . . . . 523 Trademarks . . . . . . . . . . . . . . 562Set Password . . . . . . . . . . . . . 525Set Waspassword . . . . . . . . . . . . 526 Glossary . . . . . . . . . . . . . 565Appendix A. Using the Tivoli Storage Index . . . . . . . . . . . . . . . 575Manager central scheduler . . . . . 529Overview of the Tivoli Storage Manager scheduler 529 Handling spaces in file names in schedule definitions . . . . . . . . . . . . . 530 Contents vii
  • 9. viii IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide
  • 10. 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
  • 11. 88. Query Mgmtclass command: Related options 485 96. Restore Image command: Related options 50789. Query Node command: Related options 486 97. Restore NAS command: Related options 51090. Query Options command: Related options 487 98. Restore WAS command: Related options 51291. Query Systeminfo command: Related options 492 99. Retrieve command: Related options . . . . 51492. Query WAS command: Related options 493 100. Schedule command: Related options . . . . 51693. Restore command: Related options . . . . 497 101. Selective command: Related options . . . . 51994. Restore Backupset command: Related options 501 102. Scheduled client event status codes . . . . 53995. Restore Group command: Related options 504x IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide
  • 12. 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
  • 13. 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
  • 14. 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 ExampleAbbreviations: KEYWOrdUppercase letters denote the shortestacceptable truncation. If an item appearsentirely in uppercase letters, it cannot betruncated.You can type the item in any combination ofuppercase or lowercase letters.In this example, you can enter KEYWO,KEYWORD, or KEYWOrd.Symbols: * Asterisk {} BracesEnter these symbols exactly as they appear in : Colonthe syntax diagram. , Comma = Equal Sign - Hyphen () Parentheses . Period SpaceVariables: KEYWOrd var_nameItalicized lowercase items (var_name) denotevariables.In this example, you can specify a var_namewhen you enter the KEYWORD command.Repetition:An arrow returning to the left means you canrepeat the item. repeatA character or space within the arrow means ,you must separate repeated items with thatcharacter or space. repeatA footnote by the arrow references thenumber of times you can repeat the item. (1) repeat Notes: 1 Specify repeat as many as 5 times. About this book xiii
  • 15. 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 CRelated 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 publicationsPublication title Order numberClient publicationsIBM Tivoli Storage Manager Messages SC32-0140xiv IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide
  • 16. Table 2. IBM Tivoli Storage Manager client and server publications (continued)Publication title Order numberIBM Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User’s Guide SC32-0146IBM Tivoli Storage Manager for NetWare Backup-Archive Clients Installation and User’s Guide SC32-0144IBM Tivoli Storage Manager for Macintosh Backup-Archive Clients Installation and User’s Guide SC32-0143IBM Tivoli Storage Manager for Space Management for UNIX and Linux User’s Guide SC32-0148IBM Tivoli Storage Manager Using the Application Programming Interface SC32-0147Server publicationsIBM Tivoli Storage Manager for AIX Installation Guide SC32-0134IBM Tivoli Storage Manager for AIX Administrator’s Reference SC32-0123IBM Tivoli Storage Manager for AIX Administrator’s Guide SC32-0117IBM Tivoli Storage Manager for AIX Storage Agent User’s Guide SC32-0129IBM Tivoli Storage Manager for HP-UX Installation Guide SC32-0135IBM Tivoli Storage Manager for HP-UX Administrator’s Reference SC32-0124IBM Tivoli Storage Manager for HP-UX Storage Agent User’s Guide SC32-0130IBM Tivoli Storage Manager for Linux Installation Guide SC32-0136IBM Tivoli Storage Manager for Linux Administrator’s Reference SC32-0125IBM Tivoli Storage Manager for Linux Storage Agent User’s Guide SC32-0131IBM Tivoli Storage Manager for z/OS Installation Guide SC32-0139IBM Tivoli Storage Manager for z/OS Administrator’s Reference SC32-0128IBM Tivoli Storage Manager for Sun Solaris Installation Guide SC32-0137IBM Tivoli Storage Manager for Sun Solaris Administrator’s Reference SC32-0126IBM Tivoli Storage Manager for Sun Solaris Administrator’s Guide SC32-0120IBM Tivoli Storage Manager for Sun Solaris Storage Agent User’s Guide SC32-0132IBM Tivoli Storage Manager for Windows Installation Guide SC32-0138IBM Tivoli Storage Manager for Windows Administrator’s Guide SC32-0121IBM 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
  • 17. 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
  • 18. 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.htmlReporting 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
  • 19. xviii IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide
  • 20. 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
  • 21. | 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
  • 22. | 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
  • 23. 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
  • 24. 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
  • 25. requirements. See “Using event-based policy retention protection” on page 182, “Enablearchiveretentionprotection” on page 257 and “Set Event” on page 523 for more information. Enhanced encryption Tivoli Storage Manager now supports AES (Advanced Encryption Standard) 128-bit data encryption to encrypt data during backup and archive operations using the include.encryption option. See Chapter 1, “Installing Tivoli Storage Manager,” on page 1, Chapter 4, “Backing up your data,” on page 87, and Chapter 10, “Using commands,” on page 421 for more information. Include-exclude enhancements A preview function allows you to view the objects that would be backed up or archived according to the include-exclude list. This enhancement is useful for validating the include-exclude list. The Tivoli Storage Manager Client Java GUI directory tree shows detailed information of included and excluded objects. The directory tree in the Tivoli Storage Manager ClientJava GUI allows you to select files and directories to include or exclude. See Chapter 2, “Configuring Tivoli Storage Manager,” on page 47, Chapter 4, “Backing up your data,” on page 87, Chapter 6, “Archiving and retrieving your data,” on page 159, and Chapter 10, “Using commands,” on page 421 for more information. Enhancements to query schedule command To more accurately determine the status of scheduled events, the query schedule command on a Tivoli Storage Manager Version 5.3 and above client reports new parameters. See Chapter 7, “Automating tasks,” on page 167 and Chapter 10, “Using commands,” on page 421 for more information about these enhancements. Also see the Administrator’s Guide and Administrator’s Reference for your operating system. Dynamic client tracing A new command-line utility, dsmtrace, is available to enable tracing, disable tracing, or change trace flags while the client is running. See the Problem Determination Guide for information about using this utility. Note: Tracing is an advanced diagnostic feature intended for use only at the recommendation of IBM support and development, or as outlined in the Problem Determination Guide. Client-node proxy support Backup time can be reduced and clustered configurations can store data with client-node proxy support. Tivoli Storage Manager nodes, when authorized as agent nodes, can be directed to back up or restore data on behalf of another node (the target node). This enables concurrent operations from multiple nodes to store data to the same target node and file space in parallel. The concurrent operations can reduce backup and restore times in environments such as IBM GPFS. Client nodes can also be configured with proxy node authority to support many of the systems that can be configured to support clustering failover. The asnodename option also allows data to be restored from a different system than the one which performed the backup. See “Asnodename” on page 213 for more information.xxiv IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide
  • 26. Support for deleting individual backups from a server file space If your administrator has given you authority, you can delete individual backup copies from the Tivoli Storage Manager server without deleting the entire file space. This can be useful in the following situations: v You need to delete sensitive files which were mistakenly backed up. v You need to delete a subset of backup files which were inadvertently backed up. v You need to delete files that are found to contain viruses. See “Deleting backup data” on page 103 for more information. Backing up SAN File System data You can now back up and restore SAN file system data belonging to different operating systems using the same client. You can use a single AIX or Linux system to back up all SAN file system data. The object attributes will be correctly restored, even if backup and restore of Windows-owned files was performed by a UNIX system. See “Full and partial incremental backup” on page 95 for more information. NFSV4 support Support has been added for NFSV4 file systems on AIX Version 5.3 and above. Support has also been added for NFSV4 global name space. NFSV4 ACLs are not supported.See “Backing up NFS file systems” on page 121 for more information. Toleration support for Solaris 10 Toleration support has been added for Solaris 10 on the Backup-Archive clients and the API (no local zones). HP-UX 11i V2 support HP-UX 11i V2 is supported on the Backup-Archive clients.Technical changes for Version 5.3 - December 2004 The following changes have been made to the product for this edition: New links from the backup-archive client Java™ GUI to the Tivoli Storage Manager and Tivoli Home Pages From the backup-archive client Java GUI and Web client, you can now directly access the IBM Tivoli Storage Manager web site, the IBM Tivoli web site, the IBM Tivoli Storage Manager Support web site, and the Tivoli Storage Manager Publications web site. From the backup-archive command-line interface help menu screen, the web site address is displayed. You can enter the web site address in a browser to access the IBM Tivoli Storage Manager Support web site for technical support on Tivoli Storage Manager. New options, Errorlogmax and Schedlogmax, and DSM_LOG environment variable changes Errorlogmax and Schedlogmax are new options for controlling log size. Errorlogmax specifies the maximum size for the error log, in megabytes. Schedlogmax specifies the maximum size for the scheduler log, in megabytes. See Chapter 9, “Using processing options,” on page 185 for more information. DSM_LOG environment variable changes have been made to prevent a security or data integrity problem. Logs will no longer be created in the installation directory. In addition, if the client is unable to open a required log for writing, the client process will terminate. The Tivoli Storage Summary of changes for Tivoli Storage Manager xxv
  • 27. Manager command-line client, the Web client acceptor and agent will not run without a writeable dsmerror.log. See Chapter 2, “Configuring Tivoli Storage Manager,” on page 47, Chapter 9, “Using processing options,” on page 185, and Chapter 10, “Using commands,” on page 421 for more information. Enhanced encryption Tivoli Storage Manager now supports AES (Advanced Encryption Standard) 128-bit data encryption to encrypt data during backup and archive operations using the include.encryption option. See Chapter 1, “Installing Tivoli Storage Manager,” on page 1, Chapter 4, “Backing up your data,” on page 87, and Chapter 10, “Using commands,” on page 421 for more information. Shared memory protocol support Administrators can now perform backups, restores, archives, and retrieves more quickly by improving communications between the Tivoli Storage Manager server for Linux and Solaris and the backup-archive client for Linux and Solaris. The server and the client must be configured for the shared memory protocol, and they must be on the same server system. Shared memory is an area of memory that is accessible by several processes at the same time. This support also enables the shared memory communication protocol in the Linux and Solaris storage agent for communication with the UNIX and Linux backup-archive client. See Chapter 10, “Using commands,” on page 421 for more information. Journal-based backup enhancements Multiple journal-based backup sessions are now possible. See Chapter 4, “Backing up your data,” on page 87 and Chapter 10, “Using commands,” on page 421 for more information. Include-exclude enhancements A preview function allows you to view the objects that would be backed up or archived according to the include-exclude list. This enhancement is useful for validating the include-exclude list. The Tivoli Storage Manager Client Java GUI directory tree shows detailed information of included and excluded objects. The Client Configuration Wizard and the directory tree in the Tivoli Storage Manager ClientJava GUI allow you to select files and directories to include or exclude. See Chapter 2, “Configuring Tivoli Storage Manager,” on page 47, Chapter 4, “Backing up your data,” on page 87, Chapter 6, “Archiving and retrieving your data,” on page 159, and Chapter 10, “Using commands,” on page 421 for more information. Enhancements to query schedule command To more accurately determine the status of scheduled events, the query schedule command on a Tivoli Storage Manager Version 5.3 and above client reports new parameters. See Chapter 7, “Automating tasks,” on page 167 and Chapter 10, “Using commands,” on page 421 for more information about these enhancements. Also see the Administrator’s Guide and Administrator’s Reference for your operating system.xxvi IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide
  • 28. Dynamic client tracing A new command-line utility, dsmtrace, is available to enable tracing, disable tracing, or change trace flags while the client is running. See the Problem Determination Guide for information about using this utility. Note: Tracing is an advanced diagnostic feature intended for use only at the recommendation of IBM support and development, or as outlined in the Problem Determination Guide.Client-node proxy support Backup time can be reduced and clustered configurations can store data with client-node proxy support. Tivoli Storage Manager nodes, when authorized as agent nodes, can be directed to back up or restore data on behalf of another node (the target node). This enables concurrent operations from multiple nodes to store data to the same target node and file space in parallel. The concurrent operations can reduce backup and restore times in environments such as IBM GPFS. Client nodes can also be configured with proxy node authority to support many of the systems that can be configured to support clustering failover. The asnodename option also allows data to be restored from a different system than the one which performed the backup. See “Asnodename” on page 213 for more information.Tivoli Storage Manager Administration Center The hyperlink from the new Java based Tivoli Storage Manager Administration Center to a Tivoli Storage Manager client system provides the administrator ID and encrypted password to the Web client through a Java portlet. This enables the launching of the Web client Java GUI without the administrator signing on again. The Tivoli Storage Manager Version 5.3 or higher Web client is required for this support. See “Configuring the Web client” on page 56 and the IBM Tivoli Storage Manager Administrator’s Guide for your operating system, for more information.Java GUI and Web client enhancements You can now perform the following functions from the Java GUI and the Web client: v Find files in the backup, restore, archive or retrieve window. v Back up, restore, archive, or retrieve your files by filtering file names or filtering the directory tree. v Restore your data from backup sets without a server connection. v Archive the file or directory where the symbolic link points.Support for deleting individual backups from a server file space If your administrator has given you authority, you can delete individual backup copies from the Tivoli Storage Manager server without deleting the entire file space. This can be useful in the following situations: v You need to delete sensitive files which were mistakenly backed up. v You need to delete a subset of backup files which were inadvertently backed up. v You need to delete files that are found to contain viruses. See “Deleting backup data” on page 103 for more information.Tivoli Storage Manager backup-archive client for HP-UX Itanium 2 The Tivoli Storage Manager backup-archive client supported features on HP-UX Itanium 2 are the same as those supported by the existing HP-UX client. See Chapter 1, “Installing Tivoli Storage Manager,” on page 1 for environment and installation information. Summary of changes for Tivoli Storage Manager xxvii
  • 29. Linux for zSeries® offline image backup You can now perform offline image backups on Linux for zSeries, including native Linux for zSeries volumes and partitions created by Logical Volume Manager. See “Volume device type support for an image backup” on page 112 for more information. Optimized option default values The tcpnodelay option specifies whether to send small transactions to the server, without buffering them first. Setting the tcpnodelay option to yes (the default) can improve performance in higher-speed networks. This option has been extended to all UNIX and Linux clients, except UNIX System Services client for z/OS. Table 4 lists the default values which have been optimized to improve performance. See “Tcpnodelay” on page 393 for more information. Table 4. Optimized option default values Option Change Page diskbuffsize Allows you to specify I/O 244 buffer size (in kilobytes) that the client can use to optimize backup, archive, or HSM client performance. Recommendation: Use the default value instead of specifying the diskbuffsize option. largecommbuffers This option has been 244 replaced by the diskbuffsize option. At this time, largecommbuffers will continue to be accepted by the Tivoli Storage Manager client in order to ease the transition to the new option. However, the value specified by largecommbuffers will be ignored in favor of the diskbuffsize setting. Recommendation: Discontinue the use of largecommbuffers because future releases of Tivoli Storage Manager might not accept this option. tcpadminport Specifies a separate TCP/IP 388 port number on which the server is waiting for requests for administrative client sessions, allowing secure administrative sessions within a private network. If