IBM Tivoli Storage Managerfor HP-UXVersion 7.1.4

Administrator's Reference

IBM

IBM Tivoli Storage Managerfor HP-UXVersion 7.1.4

Administrator's Reference

IBM

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

Fourth edition (December 2015)

This edition applies to version 7, release 1, modification 4 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, 2015.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

About this publication . . . . . . .. xiWho should read this guide . . . . . . . .. xiPublications . . . . . . . . . . . . .. xiConventions used in this publication . . . . .. xi

New for Tivoli Storage ManagerVersion 7.1.4 . . . . . . . . . . .. xiiiTivoli Storage Manager server updates . . . .. xiii

Simplify backup operations for data in NetAppclusters . . . . . . . . . . . . .. xiiiImprove performance for backup operationsfrom NetApp file servers . . . . . . .. xiiiPrevent error messages when your system failsto use TLS 1.1 or earlier protocols . . . .. 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 . . . . . . . . . .. 3Formatting 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 . . .. 24

Commands 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 LDAPDIRECTORY (Audit an LDAPdirectory server) . . . . . . . . . . .. 36AUDIT LIBRARY (Audit volume inventories inan automated library) . . . . . . . . .. 38AUDIT LIBVOLUME (Verify databaseinformation for a tape volume) . . . . . .. 40AUDIT LICENSES (Audit server storage usage) 42AUDIT VOLUME (Verify database informationfor a storage pool volume) . . . . . . .. 43

BACKUP commands . . . . . . . . . .. 49BACKUP DB (Back up the database) . . . .. 50BACKUP DEVCONFIG (Create backup copies ofdevice configuration information) . . . . .. 55BACKUP NODE (Back up a NAS node) . . .. 57BACKUP STGPOOL (Back up primary storagepool data to a copy storage pool) . . . . .. 62BACKUP VOLHISTORY (Save sequential volumehistory information) . . . . . . . . .. 66

BEGIN EVENTLOGGING (Begin logging events) .. 68CANCEL commands . . . . . . . . . .. 70

CANCEL EXPIRATION (Cancel an expirationprocess) . . . . . . . . . . . . .. 71CANCEL EXPORT (Delete a suspended exportoperation) . . . . . . . . . . . . .. 72CANCEL PROCESS (Cancel an administrativeprocess) . . . . . . . . . . . . .. 73CANCEL REPLICATION (Cancel nodereplication processes) . . . . . . . . .. 75CANCEL REQUEST (Cancel one or more mountrequests) . . . . . . . . . . . . .. 76CANCEL RESTORE (Cancel a restartable restoresession). . . . . . . . . . . . . .. 77CANCEL SESSION (Cancel one or more clientsessions) . . . . . . . . . . . . .. 78

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

COPY ACTIVEDATA (Copy active backup datafrom a primary storage pool to an active-datapool) . . . . . . . . . . . . . .. 96COPY CLOPTSET (Copy a client option set) .. 100

Copyright IBM Corp. 1993, 2015 iii

COPY DOMAIN (Copy a policy domain) . .. 101COPY MGMTCLASS (Copy a managementclass) . . . . . . . . . . . . . .. 103COPY POLICYSET (Copy a policy set) . . .. 105COPY PROFILE (Copy a profile) . . . . .. 107COPY SCHEDULE (Copy a client or anadministrative command schedule) . . . .. 109COPY SCRIPT (Copy a Tivoli Storage Managerscript) . . . . . . . . . . . . . .. 113COPY SERVERGROUP (Copy a server group) 114

DEACTIVATE DATA (Deactivate data for a clientnode) . . . . . . . . . . . . . . .. 115DECOMMISSION commands . . . . . . .. 118

DECOMMISSION NODE (Decommission anapplication or system) . . . . . . . .. 119DECOMMISSION VM (Decommission a virtualmachine) . . . . . . . . . . . . .. 122

DEFINE commands . . . . . . . . . .. 124DEFINE ALERTTRIGGER (Define an alerttrigger) . . . . . . . . . . . . .. 125DEFINE ASSOCIATION (Associate client nodeswith a schedule) . . . . . . . . . .. 128DEFINE BACKUPSET (Define a backup set) .. 130DEFINE CLIENTACTION (Define a one-timeclient action) . . . . . . . . . . .. 134DEFINE CLIENTOPT (Define an option to anoption set) . . . . . . . . . . . .. 140DEFINE CLOPTSET (Define a client option setname) . . . . . . . . . . . . . .. 142DEFINE COLLOCGROUP (Define a collocationgroup). . . . . . . . . . . . . .. 143DEFINE COLLOCMEMBER (Define collocationgroup member). . . . . . . . . . .. 145DEFINE COPYGROUP (Define a copy group) 149DEFINE DATAMOVER (Define a data mover) 159DEFINE DEVCLASS (Define a device class) .. 162DEFINE DOMAIN (Define a new policydomain) . . . . . . . . . . . . .. 224DEFINE DRIVE (Define a drive to a library) .. 226DEFINE EVENTSERVER (Define a server as theevent server) . . . . . . . . . . .. 231DEFINE GRPMEMBER (Add a server to aserver group) . . . . . . . . . . .. 232DEFINE LIBRARY (Define a library). . . .. 233DEFINE MACHINE (Define machineinformation for disaster recovery) . . . .. 253DEFINE MACHNODEASSOCIATION(Associate a node with a machine) . . . .. 255DEFINE MGMTCLASS (Define a managementclass) . . . . . . . . . . . . . .. 257DEFINE NODEGROUP (Define a node group) 260DEFINE NODEGROUPMEMBER (Define nodegroup member). . . . . . . . . . .. 261DEFINE PATH (Define a path) . . . . .. 262DEFINE POLICYSET (Define a policy set) . .. 271DEFINE PROFASSOCIATION (Define a profileassociation) . . . . . . . . . . . .. 273DEFINE PROFILE (Define a profile) . . . .. 279DEFINE RECMEDMACHASSOCIATION(Associate recovery media with a machine) .. 281

DEFINE RECOVERYMEDIA (Define recoverymedia) . . . . . . . . . . . . .. 283DEFINE SCHEDULE (Define a client or anadministrative command schedule) . . . .. 285DEFINE SCRATCHPADENTRY (Define ascratch pad entry) . . . . . . . . . .. 310DEFINE SCRIPT (Define a Tivoli StorageManager script) . . . . . . . . . .. 312DEFINE SERVER (Define a server forserver-to-server communications). . . . .. 315DEFINE SERVERGROUP (Define a servergroup). . . . . . . . . . . . . .. 322DEFINE SPACETRIGGER (Define the spacetrigger) . . . . . . . . . . . . .. 323DEFINE STATUSTHRESHOLD (Define a statusmonitoring threshold) . . . . . . . .. 326DEFINE STGPOOL (Define a storage pool) .. 330DEFINE SUBSCRIPTION (Define a profilesubscription) . . . . . . . . . . .. 377DEFINE VIRTUALFSMAPPING (Define avirtual file space mapping) . . . . . . .. 379DEFINE VOLUME (Define a volume in astorage pool) . . . . . . . . . . .. 381

DELETE commands . . . . . . . . . .. 387DELETE ALERTTRIGGER (Remove a messagefrom an alert trigger) . . . . . . . . .. 389DELETE ASSOCIATION (Delete the nodeassociation to a schedule) . . . . . . .. 390DELETE BACKUPSET (Delete a backup set) .. 392DELETE CLIENTOPT (Delete an option in anoption set) . . . . . . . . . . . .. 397DELETE CLOPTSET (Delete a client option set) 398DELETE COLLOCGROUP (Delete a collocationgroup). . . . . . . . . . . . . .. 399DELETE COLLOCMEMBER (Delete collocationgroup member). . . . . . . . . . .. 400DELETE COPYGROUP (Delete a backup orarchive copy group) . . . . . . . . .. 403DELETE DATAMOVER (Delete a data mover) 405DELETE DEVCLASS (Delete a device class) .. 406DELETE DOMAIN (Delete a policy domain) 407DELETE DRIVE (Delete a drive from a library) 408DELETE EVENT (Delete event records). . .. 409DELETE EVENTSERVER (Delete the definitionof the event server) . . . . . . . . .. 411DELETE FILESPACE (Delete client node datafrom the server) . . . . . . . . . .. 412DELETE GRPMEMBER (Delete a server from aserver group) . . . . . . . . . . .. 416DELETE KEYRING (