Tables
About this book
Who should read this manual
IBM Tivoli Storage Manager Web site
Conventions used in this book
Reading syntax diagrams
Related publications
Downloading or ordering publications
Contacting customer support
Reporting a problem
Internet
Summary of changes for Tivoli Storage Manager
Technical changes for version 5.2.2 - December 2003
Technical changes for version 5.2 - April 2003
Technical changes for version 5.1.5 - September 2002
Technical changes for version 5.1 - April 2002
Chapter 1. Installing Tivoli Storage Manager
Migrating from earlier versions
Upgrade path for clients and servers
NDMP support requirements (Extended Edition only)
Additional migration information
Client environment requirements
AIX client environment
HP-UX client environment
Linux on Intel x86 client environment
Linux on Intel Itanium client environment
Linux for pSeries and Linux for iSeries client environments
Linux for IBM eServer zSeries and S/390 client environments
OS/390 and z/OS UNIX System Services client environment
Solaris client environment
Client installation media on product CD-ROMs
Online startup information
Installing the backup-archive client
Installing the AIX client
Installing the HP-UX clients
Installing the Linux86 client
Installing the Linux on Intel Itanium client
Installing the Linux390 client
Installing the Linux pSeries and Linux iSeries clients
Installing the Solaris clients
Chapter 2. Configuring Tivoli Storage Manager
Root and authorized user tasks
Creating and modifying the client system options file (required root user or authorized user task)
Creating a default client user options file (optional root user or authorized user task)
Setting options in an options file
Setting environment variables
Setting language environment variables
Setting font defaults
Setting processing environment variables
Setting Bourne and Korn shell variables
Setting C shell variables
Setting API environment variables
Configuring the Web client
Configuring the client scheduler
Configuring Tivoli Storage Manager client/server communication across a firewall
Registering your workstation with a server (required root user or authorized user task)
Using closed registration
Using open registration
Associating your client node with a host system (optional)
Creating an include-exclude list (optional root user or authorized user task)
Using include-exclude options
Processing include and exclude options
Chapter 3. Getting started
Tivoli Storage Manager client authentication
Starting a GUI session
Using your Tivoli Storage Manager password
Setup Wizard
Starting a command line session
Using batch mode
Using interactive mode
Starting: Additional considerations
Starting a Web client session
Setting user privileges
Starting the client scheduler automatically
Changing your password
Sorting file lists using the Tivoli Storage Manager GUI
Displaying online help
Ending a session
Online forum
Other sources of online help
Chapter 4. Backing up your data
Planning your backups
Do you want to back up or archive files?
Pre-backup considerations
LAN-free data movement
Using an include-exclude options list to control processing
Encrypting data during backup or archive operation
File system and ACL support
Maximum file size for operations
Performing an incremental, selective, or incremental-by-date backup
Full and partial incremental backup
Incremental-by-date backup
Comparing full incremental, partial incremental, and incremental-by-date backups
Selective backup
Saving access permissions
Setting a virtual mount point
Backing up data using the GUI
Backing up data using the command line
Group backup: Backing up files from one or more file spaces
Associating a local snapshot with a server file space
Performing an image backup
Before you perform an image backup
Utilizing image backup to perform file system incremental backup
Performing an image backup using the GUI
Performing an image backup using the command line
Backing up NAS file systems
Backing up NAS file systems using the Web client GUI
Backing up NAS file systems using the command line
Backing up the WebSphere Application Server (WAS)
Backing up WAS data using the Web client
Backing up WAS data using the command line
Displaying backup processing status
Backup: Additional considerations
Understanding how files are stored
How special file systems are handled
Understanding how files are managed
Understanding how symbolic links are handled
Understanding how hard links are handled
Understanding how NFS hard and soft mounts are handled
Backing up opened files
Using wildcard characters
Chapter 5. Restoring your data
Do you want to restore an active or inactive backup?
Restoring data using the GUI
Restoring data using the command line
Performing large restore operations
No query restore
Performing point-in-time restores
Restoring an image
Peforming an image restore using the GUI
Performing an image restore using the command line
Restoring data from a backup set
Restoring an entire or partial backup set
Restoring backup sets using the GUI
Restoring backup sets using the command line client
Restoring NAS file systems
Restoring NAS file systems using the Web client
Restoring NAS files and directories using the Web client
Restoring NAS file systems using the command line
Restoring the WebSphere Application Server (WAS)
Restore: Additional considerations
Authorizing another user to restore or retrieve your files
Restoring or retrieving files from another client node
Restore or retrieve files to another workstation
Restoring a disk in case of disk loss
Deleting file spaces
Chapter 6. Archiving and retrieving your data
Archiving files
Estimating backup processing time
Archiving data using the GUI
Archiving data using the command line
Deleting archived files
Archive: Advanced considerations
Retrieving archives
Retrieving data using the GUI
Retrieving data using the command line
Understanding how your archives are managed
Chapter 7. Automating tasks
Specifying scheduling options
Configuring the client scheduler
Starting the client scheduler
Enabling firewall support
Return codes from the command line interface
Displaying information about scheduled work
Displaying information about completed work
Scheduling options for commands
Enabling or disabling scheduled commands
Chapter 8. Understanding storage management policies
Using policy domains and policy sets
Using management classes and copy groups
Displaying information about management classes and copy groups
Copy group name
Copy type
Copy frequency
Versions data exists
Versions data deleted
Retain extra versions
Retain only version
Copy serialization
Copy mode
Copy destination
Retain versions
Selecting a management class for files
Assigning a management class to files
Overriding the management class for archived files
Selecting a management class for directories
Binding and rebinding management classes to files
Rebinding backup versions of files
Using a retention grace period
Chapter 9. Using processing options
Overview of processing options
Communication options
TCP/IP options
Shared Memory options
Server and Node options
Server options
Node options
Backup and archive processing options
Restore and retrieve processing options
Scheduling options
Format options
Command processing options
Authorization options
Error processing options
Transaction processing options
Web client options
Diagnostics options
Using options with commands
Entering options with a command
Initial command line only options
Client options reference
Archmc
Archsymlinkasfile
Automount
Changingretries
Class
Clusternode
Collocatebyfilespec
Commmethod
Commrestartduration
Commrestartinterval
Compressalways
Compression
Console
Dateformat
Defaultserver
Deletefiles
Description
Detail
Dirmc
Dirsonly
Domain
Domain.image
Domain.nas
Editor
Enablelanfree
Encryptkey
Errorlogname
Errorlogretention
Exclude options
Filelist
Filename
Filesonly
Followsymbolic
Fromdate
Fromnode
Fromowner
Fromtime
Groupname
Groups
Guitreeviewafterbackup
Httpport
Ifnewer
Imagetofile
Imagetype
Inactive
Inclexcl
Include options
Incrbydate
Incremental
Lanfreecommmethod
Lanfreeshmport
Lanfreetcpport
Largecommbuffers
Latest
Localbackupset
Location
Makesparsefile
Mailprog
Managedservices
Maxcmdretries
Memoryefficientbackup
Mode
Monitor
Nasnodename
Nfstimeout
Nodename
Noprompt
Numberformat
Optfile
Password
Passwordaccess
Passworddir
Pick
Pitdate
Pittime
Postschedulecmd/Postnschedulecmd
Preschedulecmd/Prenschedulecmd
Preservelastaccessdate
Preservepath
Queryschedperiod
Quiet
Removeoperandlimit
Replace
Resourceutilization
Retryperiod
Revokeremoteaccess
Schedcmddisabled
Schedlogname
Schedlogretention
Schedmode
Scrolllines
Scrollprompt
Servername
Sessioninitiation
Shmport
Showmembers
Snapshotcachesize
Snapshotroot
Subdir
Tapeprompt
Tcpadminport
Tcpbuffsize
Tcpclientaddress
Tcpclientport
Tcpnodelay
Tcpport
Tcpserveraddress
Tcpwindowsize
Timeformat
Toc
Todate
Totime
Txnbytelimit
Type
Users
V2archive
Verbose
Verifyimage
Virtualfsname
Virtualmountpoint
Virtualnodename
Wasexphome
Washome
Wasndhome
Wasnode
Wastype
Wasuser
Webports
Chapter 10. Using commands
Starting and ending a client command session
Process commands in batch mode
Process commands in interactive mode
Entering client commands
Command name
Options
Parameters
File specification syntax
Remembering previous commands
Using wildcard characters
Entering commands
Client commands reference
Archive
Backup Group
Backup Image
Backup NAS
Backup WAS
Cancel Process
Cancel Restore
Delete Access
Delete Archive
Delete Filespace
Delete Group
Expire
Help
Incremental
Loop
Macro
Monitor Process
Query Access
Query Archive
Query Backup
Query Backupset
Query Filespace
Query Group
Query Image
Query Inclexcl
Query Mgmtclass
Query Node
Query Options
Query Restore
Query Schedule
Query Session
Query Systeminfo
Query WAS
Restart Restore
Restore
Restore Backupset
Restore Group
Restore Image
Restore NAS
Restore WAS
Retrieve
Schedule
Selective
Set Access
Set Password
Set Waspassword
Appendix A. Using the Tivoli Storage Manager central scheduler
Overview of the TSM scheduler
Handling spaces in file names in schedule definitions
Preferential start times for certain nodes
Understanding scheduler processing options
Handling return codes from preschedulecmd and postschedulecmd Scripts
Using the client acceptor to manage scheduler services versus the legacy scheduler services
Setting the client scheduler process to run as a background task and start automatically at boot time
Managing multiple schedule requirements on one machine
Restarting the scheduler process on a remote machine
Using the scheduler on clustered systems
Using the scheduler through a firewall
Troubleshooting the Tivoli Storage Manager scheduler
Investigating abnormal scheduled events
Checking the server activity log
Inspecting the Client Schedule Log
Appendix B. Configuring the backup-archive client in an HACMP takeover environment
Installing the backup-archive client
Configuring the backup-archive client to process local nodes
Configuring Tivoli Storage Manager backup-archive client to process cluster disk resources
Step 1: Register the client to a server
Step 2: Configure the client system options file
Step 3: Configure the client user options file
Defining the client as an HACMP application
Creating an HACMP resource group to add a client
Adding the client to an HACMP resource group
Notices
Trademarks
Glossary
Index