Tuesday, 25 June 2013

TSM Cheat Sheet


Command ▾Common Arguments & DescriptionCommand Description
IBMtapeutil-f /dev/IBMchanger0 inventory (Run an inventory on the library, useful to see where tapes are physically located including in the hopper (import/export station))IBM tape utility for Linux
audit librlib_name checkl=barcode (Audits the library "lib_name" and uses the barcode reader to read the storage volume label, to decrease the audit time.)Audits and synchronizes volume inventories in an automated library
audit volV0123 (Audits the volume V0123)Verify database information for a storage pool volume
cancel process3 (Cancel process number 3)Cancel an administrative process
checkin libvlib_name search=bulk status=scratch checkl=barcode (Check volumes into the library "lib_name" as scratch searching the entry/exit ports (bulk). Read the barcode on the tape for quicker checkin times. Then type "q req" - see command below.)Check scratch storage volumes from the hopper into the library
checkin libvlib_name search=bulk vollist=V0123 status=scratch checkl=barcode (Checkin volume V0123 into the library "lib_name" as scratch searching the entry/exit ports (bulk). Read the barcode on the tape for quicker checkin times. Then type "q req" - see command below.)Check a scratch storage volume from the hopper into the library
checkin libvlib_name search=bulk vollist=V0123 status=private checkl=barcode (Checkin volume V0123 into the library "lib_name" as private searching the entry/exit ports (bulk). Read the barcode on the tape for quicker checkin times. Then type "q req" - see command below.)Check a private storage volume from the hopper into the library
checkin libvlib_name search=yes status=scratch checkl=barcode (Check volumes into the server inventory of the library "lib_name" as scratch searching the library). Read the barcode on the tape for quicker checkin times. Then type "q req" - see command below.)Checkin a scratch storage volume searching the library into the library
checkin libvlib_name search=bulk status=scratch checkl=yes (Check volumes into the server inventory of the library "lib_name" as scratch searching the entry/exit ports (bulk), reading the media label (checkl=yes). Then type "q req" - see command below.)Checkin a scratch storage volume from the hopper reading the media label
checkout libvlib_name V0123 checkl=no (Checkout volume V0123 from library "lib_name" and do not check the label)Check a storage volume out of the library
checkout libvlib_name V0123 checkl=no remove=no (Checkout volume V0123 from library "lib_name" without physically moving the tape and do not check the label)Check a storage volume out of the library without moving the tape
clean drivelib_name drive_name (clean the drive "drive_name" in the library "lib_name")Clean a drive with a cleaning tape in the library
definevolume backuppool bkup01.dsm formatsize=200 (Increases the size of storage pool BACKUPPOOL by creating a 200MB volume named bkup01.dsm in BACKUPPOOL)Define a volume in a storage pool
dismountvol V0123 (Dismounts a volume V0123 from the drive)Dismount a volume from the drive
dsmadmcWith no arguments - runs the administrative command line clientStart the administrative command line client
dsmadmc-cons (Run dsmadmc in console mode to monitor TSM activities as they occur)Start an administrative client session in console mode
dsmc arc-archmc=LOGARC -deletefiles "/app/*" (Archive all files in /app binding the archived files to the LOGARC management class, then delete the files from disk after successful archival)TSM client utility - Archive files
dsmc delar /opt* -su=yes -pick (Delete archive files in archive /opt and use the "pick" command to list the archive files to select)TSM client utility - Delete archive files
dsmc i-quiet > /tmp/tsm.out (Run an incremental backup (i) and only report errors (-quiet) and direct all output to the log file /tmp/tsm.out)TSM client utility - Incremental backup
dsmc qar /opt* -subdir=yes (Display information about the files and subdirectories within the archive /opt. Run as root to see all files regardless of permissions)TSM client utility - Query archived files
dsmc qarchive /opt* (Display information about the archive /opt)TSM client utility - Query archived files
dsmc qinclexcl (Display a list of include-exclude statements in the order in which they are processed during backup and archive operations)TSM client utility - Query include-exclude statements
dsmc qsess (Display information about your session including server and server connection information)TSM client utility - Query session
dsmc rest/app/ (Restore all files in /app not including sub-directories)TSM client utility: Restore - no sub-directories
dsmc rest-replace=all -subdir=yes /app (Restore /app including sub-directories replacing all files)TSM client utility: Restore - including subdirectories
dsmc rest-subdir=yes -inactive -dateformat=1 -pitdate=01/23/2011 /app/* (Perform a point in time restore of /app including sub-directories from the 23rd Jan. The latest file at or before this date including inactive files will be restored.)TSM client utility - Point in time restore
dsmc sel/home/vera -subdir=yes /app (Execute a selective backup of /home/vera including subdirectories. A selective backup will backup files regardless of whether they have changed since the incremental backup.)TSM client utility - Selective backup
grantauthority jane classes=system (Grant system authority to the administrator jane)Grant authority to administrator
haltWith no arguments - The halt command forces an abrupt shutdown, which cancels all the admin and client node sessions even if they are not completed. Any transactions in progress interrupted by the halt command are rolled back when the server is restarted.Shutdown the server
itdt(Select S to scan for devices, select a device from the list and then select D for a firmware dump (support information log)ITDT IBM Tape Diagnostic Tool
label libvlib_name checkin=scratch search=bulk labelsource=barcode overwrite=yes (Searches library "lib_name" entry/exit ports for useable volumes to label, attempts to read bar-code label and adds them to scratch pool. Then type "q req" - see command below.)Label tape volumes
lslpp -L| grep -i tsm (Lists the installed filesets and filters out any ones with tsm in the name)Check if the TSM server or client is installed
move dataV0123 (Moves files from volume V0123 to other volumes in the same storage pool if they have space available)Move files on a storage pool volume
move drmV0123 wherestate=mountable tostate=vault (moves volume V0123 from mountable to vault. Used to ready tapes to go offsite and moves them to an exit port.)Move disaster recovery media offsite and back onsite
move drmV0123 wherestate=vaultret tostate=onsiteret (moves volume V0123 from vault retrieve to onsite retrieve)Move disaster recovery media offsite and back onsite
q actsearch=checkin begint=-6 (Query activity log for checkin processes within the last 6 hours)Query activity log
q actbegind=MM/DD/YYYY begint=HH:MM:SS (Query activity log from date and time specified)Query activity log
q assocWith no arguments - display information about which client nodes are associated with one or more schedulesQuery client node associations with a schedule
q copyWith no arguments - display information about one or more copy groupsQuery copy groups
q driveWith no arguments - display information about all drives associated with the serverQuery information about a Drive
q drmWith no arguments - display info about database backup and copy storage pool volumesQuery Disaster Recovery Media
q event* * begint=05:00 (Query client events (i.e. backups) for all domains and schedules using wildcards *, starting from 5am.)Query client scheduled and completed events
q event* * nodes=node1 (Query client events (i.e. backups) for all domains and schedules using wildcards *, for node "node1")Query client scheduled and completed events
q event* t=a (Query events for all domains using wildcard *, for administration schedules t=a short for type=admin)Query admin scheduled and completed events
q filenode1 (Display info about file spaces (as of the last incremental backup) that belong to the client node node1)Query one or more file spaces
q libvWith no arguments - query all volumes in all librariesQuery a library volume - Displays info about checked in volumes
q mountWith no arguments - display info about the status of all sequential access volumes that are mounted. (Shows if there are any tapes in the drives)Display info on mounted sequential access volumes
q nodef=d (Display detailed info about all registered nodes including TSM client version)Display info about one or more registered nodes
q optWith no arguments - display information about server options such as BufPoolSizeQuery server options
q pathWith no arguments - displays information about all paths associated with the serverQuery a Path Definition
q procWith no arguments - display all active background process informationQuery one or more server processes
q reqWith no arguments - display info about all pending mount requests. See "reply" command belowQuery one or more pending mount requests
q schschedule_name t=a f=d (Display detailed information (f=d) about the admin (t=a) schedule "schedule_name" (default displays client schedules))Displays information about schedules
q scriptWith no arguments - display info about all scriptsDisplays information about TSM scripts
q scriptscript_name f=r (Display the code of the script "script_name" to the console)Displays the code of TSM scripts
q sessWith no arguments - display information about admin and client node sessionsQuery client sessions
q statusWith no arguments - display information about system parametersQuery system parameters
q stgstgpool_name (Display detailed (f=d) information about storage pool "stgpool_name")Query storage pools
q volvol_name f=d (Display detailed info about volume "vol_name")Query storage pool volumes
q volaccess=unavailable (Display volumes with access set to unavailable)Query unavailable storage pool volumes
q volht=dbb (Display history information about full and incremental database backup volumes)Display sequential volume history information
registeradmin jane poppy (Register an administrator with a user ID of jane and a password of poppy)Register an administrator
reply2 (Use "q req" first for the ID number, then reply (if required) to inform the server you have completed a requested operation.)Allow a request to continue processing
resetbufpool (Reset the buffer pool counter)Reset the counters that track server statistics
runscript_name (Run script "script_name")Run a TSM script
setactlogretention 8 (Set the activity log retention period to 8 days)Set a value for a TSM object
setoptbufpoolsize 262144 (Update the server option bufpoolsize to 256MB without restarting the server)Set a server option for dynamic update
tapeutil-f /dev/IBMchanger0 inventory (Run an inventory on the library, useful to see where tapes are physically located including in the hopper (import/export station))IBM tape utility for AIX
upd drivelib_name drive_name online=no (Update the drive in the library "lib_name" with drive name "drive_name" to be offline)Update a drive
upd pathsource_name destination_name srct=server destt=drive library=lib_name online=yes (Change the path to the drive to online. Here source type is server and dest type is drive. Use q path to get the relevant details for this command.)Update a path to a drive
upd pathsource_name destination_name srct=server destt=library online=no (Change the path to the library to offline. Here source type is server and dest type is library. Use q path to get the relevant details for this command.)Update a path to the library
upd schschedule_name t=a startt=08:00(Update the admin schedule "schedule_name" by changing its start time to 08:00)Update an administrative schedule
upd schschedule_name t=a cmd="migrate stg notes_disk lowmig=0" active=yes(Update the admin schedule "schedule_name" by specifying the administrative command to be scheduled for processing (cmd="") and make the schedule active.)Update an administrative schedule
upd stgstgpool_name reclaim=90 (Update storage pool stgpool_name and set the reclamation threshold to 90%. Therefore if the volume has 10% utilisation or less the tape can be reclaimed and made available for resuse)Update a storage pool's reclamation threshold
upd stgstgpool_name maxscr=50 (Update the storage pool "stgpool_name" and set the "Maximum Scratch Volumes allowed" parameter to 50)Update a storage pool and set max scratch
upd volvol_name access=readwrite (Give vol_name read/write access)Change access mode for one or more storage pool volumes

1 comment: