Common TSM Command Line Options
Here are some common commands for getting started with TSM.
Most commands are executed at the TSM prompt. To launch a TSM command line session — which on most systems will require root/administrator-level direct or sudo access — type:
You may need to change to the directory where TSM lives:
- Solaris and Linux, typically /opt/tivoli/tsm/client/ba/bin
- AIX, typically /usr/tivoli/tsm/client/ba/bin
- Windows, typically C:\Program Files\tivoli\tsm\baclient
Once instantiated, you should see something like the following:
IBM Tivoli Storage Manager
Command Line Backup/Archive Client Interface – Version 5, Release 2, Level 0.
(c) Copyright by IBM Corporation and other(s) 1990, 2003. All Rights Reserved.
Node Name: TSM-SRVxxx
Session established with server TSM-SRV-01: AIX-RS/6000
Server Version 5, Release 3, Level .4
Server date/time: 03/08/05 13:18:34 Last access: 03/08/05 13:15:58
At the TSM prompt, type help or h and Enter to launc the help section, using the numbers that appear to enter the help system of your choice. For sections that are more than one screen in length, continue pressing Enter to return to the screen where you started.
Use the command quit or q at the TSM prompt to exit.
Common TSM Commands
These commands can be run from the TSM prompt, or can follow the command dsmc directly (e.g., q sched from TSM prompt, or dsmc q sched from command line or script with appropriate access.)
- dsmc query schedule (short version: q sched)
- query inclexcl (short version: q inclexcl)
- query filespace (short version: q fi)
- query archive “/home/foo/*” (short version: q arch “/home/foo/*”
- query backup “/home/foo/*” (short version: q ba “/home/foo/*”
- query mgmtclass (short version: q mgmtcl)
- query restore (short version: q rest)
- query session (short version: q se)
- query access (short version: q acc)
Ensure TSM Scheduler is Running
On a Unix system, check all processes and look to make sure dsmc is running with the command line argument schedule:
cjcase@blitzen:/home/cjcase> ps -ef|grep dsmc
root 19458 73194 0 14:42:50 pts/3 0:00 grep dsmc
root 21178 1 0 Aug 19 – 7:53 /usr/bin/dsmc schedule or /opt/tivoli/tsm/client/ba/bin/dsmcad
Common Restore Commands
These commands are used to check on files that need to be restored or for launching restores from the command line.
restore “/home/foo/*” -ina -pick
This command will let the administrator pick the file desired to be restored to the original path, /home/foo/filename. Select the file by entering the number that appears to the left of the filename, then press the letter “o.”
restore -sub=yes “/home/foo/*” /home/foo/restore/
Restore from the original path to another path; the first path is the original /home/foo/* source, the second path is the restoration target. TSM will create target directories assuming you have permissions sufficient to do so.
restore “/home/foo/*” /home/foo/restore/ -ina -pick
This will allow you to restore from either active versions or inactive versions of a file; in this context, it will allow restoration from the first (source) path to the second (target) path.
The incremental command backs up all new or changed files or directories in the default client domain or from file systems, directories, or files you specify, unless you exclude them from backup services. See the INCREMENTAL command topic for supported file systems support.
To incrementally back up selected files or directories, enter a file specification in the command. If you do not enter a file specification, the default is to back up files or directories in the default domain. See the DOMAIN topic for information on how to change which objects are included in the default domain.
For example, to run an incremental backup of the default client domain specified in your client user options file (dsm.opt); by default, file systems id all-local: incremental or inc
To run an incremental backup for the /home, /usr, and /proj file systems: incremental /home /usr /proj
To run an incremental backup for the /proj/test directory: incremental /proj/test/