IBM Tivoli Storage Managerfor WindowsVersion 7.1.5

Administrator's Reference

IBM

IBM Tivoli Storage Managerfor WindowsVersion 7.1.5

Administrator's Reference

IBM

Note:Before you use this information and the product it supports, read the information in Notices on page 1701.

Fifth edition (March 2016)

This edition applies to version 7, release 1, modification 5 of IBM Tivoli Storage Manager (product numbers5608-E01, 5608-E02, 5608-E03), and to all subsequent releases and modifications until otherwise indicated in neweditions.

Copyright IBM Corporation 1993, 2016.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

About this publication . . . . . . . . xiiiWho should read this guide . . . . . . . . xiiiPublications . . . . . . . . . . . . . . xiiiConventions used in this publication . . . . . xiiiWhat's new in Version 7.1.5. . . . . . . . . xiv

Chapter 1. Managing the server from thecommand line . . . . . . . . . . . . 1Issuing commands from the administrative client . . 1

Starting and stopping the administrative client . . 2Monitoring server activities from theadministrative client . . . . . . . . . . . 2Monitoring removable-media mounts from theadministrative client . . . . . . . . . . . 3Processing individual commands from theadministrative client . . . . . . . . . . . 3Processing a series of commands from theadministrative client . . . . . . . . . . . 4Formatting output from commands. . . . . . 4Saving command output to a specified location. . 4Administrative client options . . . . . . . . 5

Issuing commands from the Operations Center . . . 8Issuing commands from the server console . . . . 8Entering administrative commands . . . . . . . 8

Reading syntax diagrams . . . . . . . . . 9Using continuation characters to enter longcommands. . . . . . . . . . . . . . 13Naming Tivoli Storage Manager objects . . . . 13Using wildcard characters to specify objectnames . . . . . . . . . . . . . . . 14Specifying descriptions in keyword parameters 15

Controlling command processing . . . . . . . 16Server command processing . . . . . . . . 16Stopping background processes. . . . . . . 17

Performing tasks concurrently on multiple servers 17Routing commands to a single server. . . . . 18Routing commands to multiple servers . . . . 18Routing commands to a server group. . . . . 18Routing commands to server groups . . . . . 19Routing commands to two servers and a servergroup . . . . . . . . . . . . . . . 19Routing commands inside scripts . . . . . . 19

Privilege classes for commands . . . . . . . . 20Commands requiring system privilege . . . . 20Commands requiring policy privilege . . . . 23Commands requiring storage privilege . . . . 24Commands requiring operator privilege . . . . 25Commands any administrator can issue . . . . 26

Chapter 2. Administrative commands 29ACCEPT DATE (Accepts the current system date) 30ACTIVATE POLICYSET (Activate a new policy set) 31ASSIGN DEFMGMTCLASS (Assign a defaultmanagement class) . . . . . . . . . . . . 33AUDIT commands . . . . . . . . . . . . 35

AUDIT CONTAINER commands . . . . . . 36AUDIT LDAPDIRECTORY (Audit an LDAPdirectory server) . . . . . . . . . . . . 43AUDIT LIBRARY (Audit volume inventories inan automated library) . . . . . . . . . . 45AUDIT LIBVOLUME (Verify databaseinformation for a tape volume) . . . . . . . 47AUDIT LICENSES (Audit server storage usage) 49AUDIT VOLUME (Verify database informationfor a storage pool volume) . . . . . . . . 50

BACKUP commands . . . . . . . . . . . 56BACKUP DB (Back up the database) . . . . . 57BACKUP DEVCONFIG (Create backup copies ofdevice configuration information) . . . . . . 63BACKUP NODE (Back up a NAS node) . . . . 65BACKUP STGPOOL (Back up primary storagepool data to a copy storage pool) . . . . . . 70BACKUP VOLHISTORY (Save sequential volumehistory information) . . . . . . . . . . 74

BEGIN EVENTLOGGING (Begin logging events) . . 76CANCEL commands . . . . . . . . . . . 78

CANCEL EXPIRATION (Cancel an expirationprocess) . . . . . . . . . . . . . . 79CANCEL EXPORT (Delete a suspended exportoperation) . . . . . . . . . . . . . . 80CANCEL PROCESS (Cancel an administrativeprocess) . . . . . . . . . . . . . . 81CANCEL REPLICATION (Cancel nodereplication processes) . . . . . . . . . . 83CANCEL REQUEST (Cancel one or more mountrequests) . . . . . . . . . . . . . . 84CANCEL RESTORE (Cancel a restartable restoresession). . . . . . . . . . . . . . . 85CANCEL SESSION (Cancel one or more clientsessions) . . . . . . . . . . . . . . 86

CHECKIN LIBVOLUME (Check a storage volumeinto a library). . . . . . . . . . . . . . 87CHECKOUT LIBVOLUME (Check a storage volumeout of a library) . . . . . . . . . . . . . 95CLEAN DRIVE (Clean a drive) . . . . . . . 101COMMIT (Control committing of commands in amacro). . . . . . . . . . . . . . . . 102COPY commands . . . . . . . . . . . . 103

COPY ACTIVEDATA (Copy active backup datafrom a primary storage pool to an active-datapool) . . . . . . . . . . . . . . . 104COPY CLOPTSET (Copy a client option set) . . 108COPY DOMAIN (Copy a policy domain) . . . 109COPY MGMTCLASS (Copy a managementclass) . . . . . . . . . . . . . . . 111COPY POLICYSET (Copy a policy set) . . . . 113COPY PROFILE (Copy a profile) . . . . . . 115COPY SCHEDULE (Copy a client or anadministrative command schedule) . . . . . 117COPY SCRIPT (Copy a Tivoli Storage Managerscript) . . . . . . . . . . . . . . . 121

Copyright IBM Corp. 1993, 2016 iii

COPY SERVERGROUP (Copy a server group) 122DEACTIVATE DATA (Deactivate data for a clientnode) . . . . . . . . . . . . . . . . 123DECOMMISSION commands . . . . . . . . 126

DECOMMISSION NODE (Decommission anapplication or system) . . . . . . . . . 127DECOMMISSION VM (Decommission a virtualmachine) . . . . . . . . . . . . . . 130

DEFINE commands . . . . . . . . . . . 132DEFINE ALERTTRIGGER (Define an alerttrigger) . . . . . . . . . . . . . . 134DEFINE ASSOCIATION (Associate client nodeswith a schedule) . . . . . . . . . . . 137DEFINE BACKUPSET (Define a backup set) . . 139DEFINE CLIENTACTION (Define a one-timeclient action) . . . . . . . . . . . . 143DEFINE CLIENTOPT (Define an option to anoption set) . . . . . . . . . . . . . 149DEFINE CLOPTSET (Define a client option setname) . . . . . . . . . . . . . . . 151DEFINE COLLOCGROUP (Define a collocationgroup). . . . . . . . . . . . . . . 152DEFINE COLLOCMEMBER (Define collocationgroup member). . . . . . . . . . . . 154DEFINE COPYGROUP (Define a copy group) 158DEFINE DATAMOVER (Define a data mover) 168DEFINE DEVCLASS (Define a device class) . . 171DEFINE DOMAIN (Define a new policydomain) . . . . . . . . . . . . . . 233DEFINE DRIVE (Define a drive to a library) . . 235DEFINE EVENTSERVER (Define a server as theevent server) . . . . . . . . . . . . 240DEFINE GRPMEMBER (Add a server to aserver group) . . . . . . . . . . . . 241DEFINE LIBRARY (Define a library). . . . . 242DEFINE MACHINE (Define machineinformation for disaster recovery) . . . . . 262DEFINE MACHNODEASSOCIATION(Associate a node with a machine) . . . . . 264DEFINE MGMTCLASS (Define a managementclass) . . . . . . . . . . . . . . . 266DEFINE NODEGROUP (Define a node group) 269DEFINE NODEGROUPMEMBER (Define nodegroup member). . . . . . . . . . . . 270DEFINE PATH (Define a path) . . . . . . 271DEFINE POLICYSET (Define a policy set) . . . 281DEFINE PROFASSOCIATION (Define a profileassociation) . . . . . . . . . . . . . 283DEFINE PROFILE (Define a profile) . . . . . 289DEFINE RECMEDMACHASSOCIATION(Associate recovery media with a machine) . . 291DEFINE RECOVERYMEDIA (Define recoverymedia) . . . . . . . . . . . . . . 293DEFINE SCHEDULE (Define a client or anadministrative command schedule) . . . . . 295DEFINE SCRATCHPADENTRY (Define ascratch pad entry) . . . . . . . . . . . 320DEFINE SCRIPT (Define a Tivoli StorageManager script) . . . . . . . . . . . 322DEFINE SERVER (Define a server forserver-to-server communications). . . . . . 325

DEFINE SERVERGROUP (Define a servergroup). . . . . . . . . . . . . . . 332DEFINE SPACETRIGGER (Define the spacetrigger) . . . . . . . . . . . . . . 333DEFINE STATUSTHRESHOLD (Define a statusmonitoring threshold) . . . . . . . . . 336DEFINE STGPOOL (Define a storage pool) . . 340DEFINE STGPOOLDIRECTORY (Define astorage pool directory) . . . . . . . . . 396DEFINE SUBSCRIPTION (Define a profilesubscription) . . . . . . . . . . . . 398DEFINE VIRTUALFSMAPPING (Define avirtual file space mapping) . . . . . . . . 400DEFINE VOLUME (Define a volume in astorage pool) . . . . . . . . . . . . 402

DELETE commands . . . . . . . . . . . 408DELETE ALERTTRIGGER (Remove a messagefrom an alert trigger) . . . . . . . . . . 410DELETE ASSOCIATION (Delete the nodeassociation to a schedule) . . . . . . . . 411DELETE BACKUPSET (Delete a backup set) . . 413DELETE CLIENTOPT (Delete an option in anoption set) . . . . . . . . . . . . . 418DELETE CLOPTSET (Delete a client option set) 419DELETE COLLOCGROUP (Delete a collocationgroup). . . . . . . . . . . . . . . 420DELETE COLLOCMEMBER (Delete collocationgroup member). . . . . . . . . . . . 421DELETE COPYGROUP (Delete a backup orarchive copy group) . . . . . . . . . . 424DELETE DATAMOVER (Delete a data mover) 426DELETE DEDUPSTATS (Delete datadeduplication statistics) . . . . . . . . . 427DELETE DEVCLASS (Delete a device class) . . 431DELETE DOMAIN (Delete a policy domain) 432DELETE DRIVE (Delete a drive from a library) 433DELETE EVENT (Delete event records). . . . 434DELETE EVENTSERVER (Delete the definitionof the event server) . . . . . . . . . . 436DELETE FILESPACE (Delete client node datafrom the server) . . . . . . . . . . . 437DELETE GRPMEMBER (Delete a server from aserver group) . . . . . . . . . . . . 441DELETE KEYRING (Delete passwordinformation in the key datab