tivoli storage manager for aix administrator's reference

Tivoli Storage Managerfor AIX

Administrators Reference

Version 6.1

SC23-9775-01

NoteBefore using this information and the product it supports, read the information in Notices on page 1281.

This edition applies to Version 6.1 of IBM Tivoli Storage Manager and to all subsequent releases and modificationsuntil otherwise indicated in new editions or technical newsletters.

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

ContentsPreface . . . . . . . . . . . . . . . xiWho should read this publication . . . . . . . xiPublications . . . . . . . . . . . . . . xi

Tivoli Storage Manager publications . . . . . xiRelated hardware publications . . . . . . . xiii

Support information . . . . . . . . . . . xiiiGetting technical training . . . . . . . . xivSearching knowledge bases . . . . . . . . xivContacting IBM Software Support . . . . . . xv

Conventions used in this publication . . . . . xvii

New for IBM Tivoli Storage ManagerVersion 6.1. . . . . . . . . . . . . xixNew for the server in Version 6.1.2 . . . . . . xix

Enabled functions . . . . . . . . . . . xixLicensing changes . . . . . . . . . . . xixTSMDLST utility for AIX . . . . . . . . . xxDevice support for AIX . . . . . . . . . xxPREVIEW parameter for DSMSERV INSERTDB xxNew server option SANDISCOVERYTIMEOUT xx

New for the server in Version 6.1.0 . . . . . . xxDisabled functions in 6.1.0 and 6.1.1 . . . . . xxiChanges to the Version 6.1 AdministrationCenter . . . . . . . . . . . . . . . xxiData deduplication . . . . . . . . . . xxiiiStorage devices . . . . . . . . . . . xxivDisaster recovery manager support foractive-data pools . . . . . . . . . . . xxvEXPIRE INVENTORY command enhancements xxviNo-query restore changes . . . . . . . . xxviiServer database . . . . . . . . . . . xxviiSupport for NetApp SnapMirror to Tapefeature . . . . . . . . . . . . . . xxviiReporting and monitoring feature . . . . . xxviiODBC driver support . . . . . . . . . xxviiiBackup sets and client node enhancements xxviii

Command and option changes . . . xxixNew server commands, utilities, and options . . xxixUpdated server commands, utilities, and options xxxiDeleted server commands, utilities, and options xxxivChanges to the SELECT command . . . . . xxxvii

Chapter 1. Administering the serverfrom the command 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 . . . . . . . . . . . 2Processing commands one at a time from theadministrative client . . . . . . . . . . . 3

Processing 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 Administration Center . 7Issuing commands from the server console . . . . 7Entering administrative commands . . . . . . . 8

Reading syntax diagrams . . . . . . . . . 8Entering long commands . . . . . . . . . 11Naming Tivoli Storage Manager objects . . . . 12Using wildcard characters to specify objectnames . . . . . . . . . . . . . . . 13Specifying descriptions in keyword parameters 14

Controlling command processing . . . . . . . 14Server command processing . . . . . . . . 14Cancelling commands . . . . . . . . . . 15

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

Privilege classes for commands . . . . . . . . 18Commands requiring system privilege . . . . 18Commands requiring policy privilege . . . . 21Commands requiring storage privilege . . . . 22Commands requiring operator privilege . . . . 23Commands any administrator can issue . . . . 24

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

AUDIT LIBRARY (Audit volume inventories inan automated library) . . . . . . . . . . 34AUDIT LICENSES (Audit server storage usage) 36AUDIT VOLUME (Verify database informationfor a storage pool volume) . . . . . . . . 37

BACKUP commands . . . . . . . . . . . 43BACKUP DB (Back up the database) . . . . . 44BACKUP DEVCONFIG (Create backup copies ofdevice configuration information) . . . . . . 47BACKUP NODE (Back up a NAS node) . . . . 49BACKUP STGPOOL (Back up primary storagepool to copy storage pool) . . . . . . . . 54BACKUP VOLHISTORY (Save sequential volumehistory information) . . . . . . . . . . 58

BEGIN EVENTLOGGING (Begin logging events) . . 60CANCEL commands . . . . . . . . . . . 62

Copyright IBM Corp. 1993, 2009 iii

||||||||||||||||

CANCEL EXPIRATION (Cancel an expirationprocess) . . . . . . . . . . . . . . 63CANCEL EXPORT (Delete a suspended exportoperation) . . . . . . . . . . . . . . 64CANCEL PROCESS (Cancel an administrativeprocess) . . . . . . . . . . . . . . 65CANCEL REQUEST (Cancel one or more mountrequests) . . . . . . . . . . . . . . 67CANCEL RESTORE (Cancel a restartable restoresession). . . . . . . . . . . . . . . 68CANCEL SESSION (Cancel one or more clientsessions) . . . . . . . . . . . . . . 69

CHECKIN LIBVOLUME (Check a storage volumeinto a library). . . . . . . . . . . . . . 70CHECKOUT LIBVOLUME (Check a storage volumeout of a library) . . . . . . . . . . . . . 77CLEAN DRIVE (Clean a drive) . . . . . . . . 83COMMIT (Control committing of commands in amacro) . . . . . . . . . . . . . . . . 84COPY commands . . . . . . . . . . . . 85

COPY ACTIVEDATA (Copy active backup datafrom a primary storage pool to an active-datapool) . . . . . . . . . . . . . . . 86COPY CLOPTSET (Copy a client option set) . . 90COPY DOMAIN (Copy a policy domain) . . . 91COPY MGMTCLASS (Copy a management class) 93COPY POLICYSET (Copy a policy set) . . . . 95COPY PROFILE (Copy a profile) . . . . . . 97COPY SCHEDULE (Copy a client or anadministrative command schedule) . . . . . 99COPY SCRIPT (Copy a Tivoli Storage Managerscript) . . . . . . . . . . . . . . . 103COPY SERVERGROUP (Copy a server group) 104

DEFINE commands . . . . . . . . . . . 105DEFINE ASSOCIATION (Associate client nodeswith a schedule) . . . . . . . . . . . 106DEFINE BACKUPSET (Define a backup set) . . 108DEFINE CLIENTACTION (Define a one-timeclient action). . . . . . . . . . . . . 113DEFINE CLIENTOPT (Define an option to anoption set) . . . . . . . . . . . . . 118DEFINE CLOPTSET (Define a client option setname) . . . . . . . . . . . . . . . 121DEFINE COLLOCGROUP (Define a collocationgroup). . . . . . . . . . . . . . . 122DEFINE COLLOCMEMBER (Define collocationgroup member). . . . . . . . . . . . 124DEFINE COPYGROUP (Define a copy group) 126DEFINE DATAMOVER (Define a data mover) 136DEFINE DEVCLASS (Define a device class) . . 139DEFINE DOMAIN (Define a new policydomain) . . . . . . . . . . . . . . 214DEFINE DRIVE (Define a drive to a library) . . 216DEFINE EVENTSERVER (Define a server as theevent server) . . . . . . . . . . . . 220DEFINE GRPMEMBER (Add a server to aserver group) . . . . . . . . . . . . 221DEFINE LIBRARY (Define a library). . . . . 222DEFINE MACHINE (Define machineinformation for disaster recovery) . . . . . 231

DEFINE MACHNODEASSOCIATION(Associate a node with a machine) . . . . . 233DEFINE MGMTCLASS (Define a managementclass) . . . . . . . . . . . . . . . 235DEFINE NODEGROUP (Define a node group) 238DEFINE NODEGROUPMEMBER (Define nodegroup member). . . . . . . . . . . . 239DEFINE PATH (Define a path) . . . . . . 240DEFINE POLICYSET (Define a policy set) . . . 246DEFINE PROFASSOCIATION (Define a profileassociation) . . . . . . . . . . . . . 248DEFINE PROFILE (Define a profile) . . . . . 254DEFINE RECMEDMACHASSOCIATION(Associate recovery media with a machine) . . 256DEFINE RECOVERYMEDIA (Define recoverymedia) . . . . . . . . . . . . . . 258DEFINE SCHEDULE (Define a client or anadministrative command schedule) . . . . . 260DEFINE SCRIPT (Define a Tivoli StorageManager script) . . . . . . . . . . . 281DEFINE SERVER (Define a server forserver-to-server communications). . . . . . 283DEFINE SERVERGROUP (Define a servergroup). . . . . . . . . . . . . . . 288DEFINE SPACETRIGGER (Define the spacetrigger) . . . . . . . . . . . . . . 289DEFINE STGPOOL (Define a storage pool) . . 292DEFINE SUBSCRIPTION (Define a profilesubscription) . . . . . . . . . . . . 333DEFINE VIRTUALFSMAPPING (Define avirtual file space mapping) . . . . . . . . 335DEFINE VOLUME (Define a volume in astorage pool) . . . . . . . . . . . . 337

DELETE commands . . . . . . . . . . . 342DELETE ASSOCIATION (Delete the nodeassociation to a schedule) . . . . . . . . 344DELETE BACKUPSET (Delete a backup set) . . 346DELETE CLIENTOPT (Delete an option in anoption set) . . . . . . . . . . . . . 351DELETE CLOPTSET (Delete a client option set) 352DELETE COLLOCGROUP (Delete a collocationgroup). . . . . . . . . . . . . . . 353DELETE COLLOCMEMBER (Delete collocationgroup member). . . . . . . . . . . . 354DELETE COPYGROUP (Delete a backup orarchive copy group) . . . . . . . . . . 356DELETE DATAMOVER (Delete a data mover) 358DELETE DEVCLASS (Delete a device class) . . 359DELETE DOMAIN (Delete a policy domain) 360DELETE DRIVE (Delete a drive from a library) 361DELETE EVENT (Delete event records). . . . 362DELETE EVENTSERVER (Delete the definitionof the event server) . . . . . . . . . . 364DELETE FILESPACE (Delete client node datafrom the server) . . . . . . . . . . . 365DELETE GRPMEMBER (Delete a server from aserver group) . . . . . . . . . . . . 369DELETE KEYRING (Delete passwordinformation in the certificate key database) . . 370DELETE LIBRARY (Delete a library). . . . . 371

iv IBM Tivoli Storage Manager for AIX: Administrators Reference

DELETE MACHINE (Delete machineinformation) . . . . . . . . . . . . . 372DELETE MACHNODEASSOCIATION (Deleteassociation between a machine and a node) . . 373DELETE MGMTCLASS (Delete a managementclass) . . . . . . . . . . . . . . . 374DELETE NODEGROUP (Delete a node group) 375DELETE NODEGROUPMEMBER (Delete nodegroup member). . . . . . . . . . . . 376DELETE PATH (Delete a path) . . . . . . 377DELETE POLICYSET (Delete a policy set) . . . 379DELETE PROFASSOCIATION (Delete a profileassociation) . . . . . . . . . . . . . 380DELETE PROFILE (Delete a profile) . . . . . 383DELETE RECMEDMACHASSOCIATION(Delete recovery media and machineassociation) . . . . . . . . . . . . . 385DELETE RECOVERYMEDIA (Delete recoverymedia) . . . . . . . . . . . . . . 386DELETE SCHEDULE (Delete a client or anadministrative command schedule) . . . . . 387DELETE SCRIPT (Delete command lines from ascript or delete the entire script) . . . . . . 390DELETE SERVER (Delete a server definition) 391DELETE SERVERGROUP (Delete a servergroup). . . . . . . . . . . . . . . 392DELETE SPACETRIGGER (Delete the storagepool space triggers) . . . . . . . . . . 393DELETE STGPOOL (Delete a storage pool) . . 394DELETE SUBSCRIBER (Delete subscriptionsfrom a configuration manager database) . . . 395DELETE SUBSCRIPTION (Delete a profilesubscription) . . . . . . . . . . . . 396DELETE VIRTUALFSMAPPING (Delete avirtual file space mapping) . . . . . . . . 397DELETE VOLHISTORY (Delete sequentialvolume history information) . . . . . . . 398DELETE VOLUME (Delete a storage poolvolume) . . . . . . . . . . . . . . 403

DISABLE commands . . . . . . . . . . . 406DISABLE EVENTS (Disable events for eventlogging) . . . . . . . . . . . . . . 407DISABLE SESSIONS (Temporarily prevent clientnode access to the server) . . . . . . . . 411

DISMOUNT command . . . . . . . . . . 413DISMOUNT VOLUME (Dismount a volume byvolume name) . . . . . . . . . . . . 414

DISPLAY OBJNAME (Display a full object name) 415ENABLE commands . . . . . . . . . . . 416

ENABLE EVENTS (Enable server or clientevents for logging) . . . . . . . . . . 417ENABLE SESSIONS (Resume user activity onthe server) . . . . . . . . . . . . . 420

END EVENTLOGGING (Stop logging events) . . 422EXPIRE INVENTORY (Manually start inventoryexpiration processing) . . . . . . . . . . 424EXPORT commands . . . . . . . . . . . 428

EXPORT ADMIN (Export administratorinformation) . . . . . . . . . . . . . 429EXPORT NODE (Export client nodeinformation) . . . . . . . . . . . . . 435

EXPORT POLICY (Export policy information) 453EXPORT SERVER (Export server information) 459

EXTEND DBSPACE (Increase space for thedatabase) . . . . . . . . . . . . . . . 474GENERATE commands . . . . . . . . . . 475

GENERATE BACKUPSET (Generate a backupset of a clients data) . . . . . . . . . . 476GENERATE BACKUPSETTOC (Generate a tableof contents for a backup set) . . . . . . . 484

GRANT commands . . . . . . . . . . . 487GRANT AUTHORITY (Add administratorauthority) . . . . . . . . . . . . . 488GRANT PROXYNODE (Grant proxy authorityto a client node) . . . . . . . . . . . 492

HALT (Shut down the server) . . . . . . . . 493HELP (Get help on commands and error messages) 495IDENTIFY DUPLICATES (Identify duplicate datain a storage pool) . . . . . . . . . . . . 497IMPORT commands . . . . . . . . . . . 501

IMPORT ADMIN (Import administratorinformation) . . . . . . . . . . . . . 502IMPORT NODE (Import client nodeinformation) . . . . . . . . . . . . . 505IMPORT POLICY (Import policy information) 511IMPORT SERVER (Import server information) 514

INSERT MACHINE (Insert machine characteristicsinformation or recovery instructions) . . . . . 519ISSUE MESSAGE (Issue a message from a serverscript) . . . . . . . . . . . . . . . . 521LABEL LIBVOLUME (Label a library volume) . . 523LOCK commands . . . . . . . . . . . . 529

LOCK ADMIN (Lock out an administrator) . . 530LOCK NODE (Lock out a client node) . . . . 531LOCK PROFILE (Lock a profile) . . . . . . 532

MACRO (Invoke a macro) . . . . . . . . . 534MIGRATE STGPOOL (Migrate storage pool to nextstorage pool) . . . . . . . . . . . . . 536MOVE commands . . . . . . . . . . . . 539

MOVE DATA (Move files on a storage poolvolume) . . . . . . . . . . . . . . 540MOVE DRMEDIA (Move disaster recoverymedia offsite and back onsite) . . . . . . . 544MOVE GRPMEMBER (Move a server groupmember) . . . . . . . . . . . . . . 558MOVE MEDIA (Move sequential access storagepool media) . . . . . . . . . . . . . 559MOVE NODEDATA (Move data by node in asequential access storage pool) . . . . . . 567

NOTIFY SUBSCRIBERS (Notify managed serversto update profiles). . . . . . . . . . . . 576PARALLEL (Run multiple commands in a script inparallel) . . . . . . . . . . . . . . . 577PING SERVER (Test the connection betweenservers) . . . . . . . . . . . . . . . 579PREPARE (Create a recovery plan file) . . . . . 580QUERY commands . . . . . . . . . . . 585

QUERY ACTLOG (Query the activity log) . . . 587QUERY ADMIN (Display administratorinformation) . . . . . . . . . . . . . 592QUERY ASSOCIATION (Query client nodeassociations with a schedule) . . . . . . . 596

Contents v

QUERY AUDITOCCUPANCY (Query clientnode storage utilization). . . . . . . . . 598QUERY BACKUPSET (Query a backup set) . . 601QUERY BACKUPSETCONTENTS (Querycontents of a backup set) . . . . . . . . 606QUERY CLOPTSET (Query a client option set) 609QUERY COLLOCGROUP (Query a collocationgroup) . . . . . . . . . . . . . . . 611QUERY CONTENT (Query the contents of astorage pool volume) . . . . . . . . . . 614QUERY COPYGROUP (Query copy groups) . . 621QUERY DATAMOVER (Display data moverdefinitions) . . . . . . . . . . . . . 626QUERY DB (Display database information) . . 629QUERY DBSPACE (Display database storagespace) . . . . . . . . . . . . . . . 632QUERY DEVCLASS (Display information onone or more device classes). . . . . . . . 633QUERY DIRSPACE (Query storage utilization ofFILE directories) . . . . . . . . . . . 637QUERY DOMAIN (Query a policy domain) . . 638QUERY DRIVE (Query information about adrive) . . . . . . . . . . . . . . . 641QUERY DRMEDIA (Query disaster recoverymedia) . . . . . . . . . . . . . . 645QUERY DRMSTATUS (Query disaster recoverymanager system parameters) . . . . . . . 654QUERY ENABLED (Query enabled events) . . 657QUERY EVENT (Query scheduled andcompleted events) . . . . . . . . . . . 659QUERY EVENTRULES (Query rules for serveror client events) . . . . . . . . . . . 671QUERY EVENTSERVER (Query the eventserver). . . . . . . . . . . . . . . 673QUERY EXPORT (Query for active orsuspended export operations) . . . . . . . 674QUERY FILESPACE (Query one or more filespaces) . . . . . . . . . . . . . . 681QUERY LIBRARY (Query a library) . . . . . 686QUERY LIBVOLUME (Query a library volume) 689QUERY LICENSE (Display license information) 692QUERY LOG (Display information on therecovery log) . . . . . . . . . . . . 693QUERY MACHINE (Query machineinformation) . . . . . . . . . . . . . 695QUERY MEDIA (Query sequential accessstorage pool media) . . . . . . . . . . 698QUERY MGMTCLASS (Query a managementclass) . . . . . . . . . . . . . . . 704QUERY MOUNT (Display information onmounted sequential access volumes). . . . . 707QUERY NASBACKUP (Query NAS backupimages) . . . . . . . . . . . . . . 708QUERY NODE (Query nodes) . . . . . . . 712QUERY NODEDATA (Query client data involumes) . . . . . . . . . . . . . . 719QUERY NODEGROUP (Query a node group) 722QUERY OCCUPANCY (Query client file spacesin storage pools) . . . . . . . . . . . 724QUERY OPTION (Query server options) . . . 728QUERY PATH (Display a path definition) . . . 729

QUERY POLICYSET (Query a policy set) . . . 733QUERY PROCESS (Query one or more serverprocesses) . . . . . . . . . . . . . 736QUERY PROFILE (Query a profile) . . . . . 738QUERY PROXYNODE (Query proxy authorityfor a client node) . . . . . . . . . . . 741QUERY RECOVERYMEDIA (Query recoverymedia) . . . . . . . . . . . . . . 742QUERY REQUEST (Query one or more pendingmount requests) . . . . . . . . . . . 745QUERY RESTORE (Query restartable restoresessions) . . . . . . . . . . . . . . 746QUERY RPFCONTENT (Query recovery planfile contents stored on a target server) . . . . 749QUERY RPFILE (Query recovery plan fileinformation stored on a target server) . . . . 751QUERY SAN (Query the devices on the SAN) 754QUERY SCHEDULE (Query schedules). . . . 757QUERY SCRIPT (Query Tivoli Storage Managerscripts) . . . . . . . . . . . . . . 765QUERY SERVER (Query a server) . . . . . 768QUERY SERVERGROUP (Query a server group) 772QUERY SESSION (Query client sessions) . . . 774QUERY SHREDSTATUS (Query shreddingstatus ) . . . . . . . . . . . . . . 778QUERY SPACETRIGGER (Query the spacetriggers) . . . . . . . . . . . . . . 780QUERY STATUS (Query system parameters) 782QUERY STGPOOL (Query storage pools) . . . 788QUERY SUBSCRIBER (Display subscriberinformation) . . . . . . . . . . . . . 799QUERY SUBSCRIPTION (Display subscriptioninformation) . . . . . . . . . . . . . 801QUERY SYSTEM (Query the systemconfiguration and capacity). . . . . . . . 803QUERY TAPEALERTMSG (Display status ofSET TAPEALERTMSG command) . . . . . 805QUERY TOC (Display table of contents for abackup image) . . . . . . . . . . . . 806QUERY VIRTUALFSMAPPING (Query a virtualfile space mapping) . . . . . . . . . . 809QUERY VOLHISTORY (Display sequentialvolume history information) . . . . . . . 811QUERY VOLUME (Query storage poolvolumes) . . . . . . . . . . . . . . 818

QUIT (End the interactive mode of theadministrative client) . . . . . . . . . . . 825RECLAIM STGPOOL (Reclaim volumes in asequential-access storage pool) . . . . . . . 826RECONCILE VOLUMES (Reconcile differences inthe virtual volume definitions) . . . . . . . 829REGISTER commands . . . . . . . . . . 832

REGISTER ADMIN (Register an administrator) 833REGISTER LICENSE (Register a new license) 835REGISTER NODE (Register a node) . . . . . 837

REMOVE commands . . . . . . . . . . . 847REMOVE ADMIN (Delete an administrator) . . 848REMOVE NODE (Delete a node or anassociated machine node) . . . . . . . . 849

RENAME commands. . . . . . . . . . . 851RENAME ADMIN (Rename an administrator) 852

vi IBM Tivoli Storage Manager for AIX: Administrators Reference

RENAME FILESPACE (Rename a client filespace on the server) . . . . . . . . . . 853RENAME NODE (Rename a node) . . . . . 856RENAME SCRIPT (Rename a Tivoli StorageManager script) . . . . . . . . . . . 857RENAME SERVERGROUP (Rename a servergroup). . . . . . . . . . . . . . . 858RENAME STGPOOL (Change the name of astorage pool) . . . . . . . . . . . . 859

REPLY (Allow a request to continue processing) 860RESET PASSEXP (Reset password expiration) . . 861RESTART EXPORT (Restart a suspended exportoperation) . . . . . . . . . . . . . . 863RESTORE commands. . . . . . . . . . . 865

RESTORE NODE (Restore a NAS node) . . . 866RESTORE STGPOOL (Restore storage pool datafrom a copy pool or an active-data pool) . . . 871RESTORE VOLUME (Restore primary volumedata from a copy pool or an active-data pool) . 875

REVOKE commands . . . . . . . . . . . 880REVOKE AUTHORITY (Remove administratorauthority) . . . . . . . . . . . . . 881REVOKE PROXYNODE (Revoke proxyauthority for a client node) . . . . . . . . 885

ROLLBACK (Rollback uncommitted changes in amacro). . . . . . . . . . . . . . . . 886RUN (Run a Tivoli Storage Manager script) . . . 887SELECT (Perform an SQL query of the IBM TivoliStorage Manager database) . . . . . . . . . 890SERIAL (Run multiple commands in a script inserial) . . . . . . . . . . . . . . . . 897SET commands . . . . . . . . . . . . . 898

SET ACCOUNTING (Set accounting records onor off) . . . . . . . . . . . . . . . 900SET ACTLOGRETENTION (Set the retentionperiod or the size of the activity log) . . . . 901SET ARCHIVERETENTIONPROTECTION(Activate data retention protection) . . . . . 903SET AUTHENTICATION (Set passwordauthentication) . . . . . . . . . . . . 905SET CLIENTACTDURATION (Set the durationperiod for the client action). . . . . . . . 906SET CONFIGMANAGER (Specify aconfiguration manager) . . . . . . . . . 907SET CONFIGREFRESH (Set managed serverconfiguration refresh). . . . . . . . . . 908SET CONTEXTMESSAGING (Set messagecontext reporting on or off) . . . . . . . . 909SET CROSSDEFINE (Specifies whether tocross-define servers) . . . . . . . . . . 910SET DBRECOVERY (Set the device class forautomatic backups) . . . . . . . . . . 911SET DBREPORTMODE (Set the level ofdatabase reporting) . . . . . . . . . . 912SET DRMACTIVEDATASTGPOOL (Specify theactive-data pools to be managed by DRM) . . 913SET DRMCHECKLABEL (Specify labelchecking) . . . . . . . . . . . . . . 915SET DRMCMDFILENAME (Specify the name ofa file to contain commands) . . . . . . . 916

SET DRMCOPYSTGPOOL (Specify the copystorage pools to be managed by DRM) . . . . 917SET DRMCOURIERNAME (Specify the couriername) . . . . . . . . . . . . . . . 918SET DRMDBBACKUPEXPIREDAYS (Specify DBbackup series expiration) . . . . . . . . 919SET DRMFILEPROCESS (Specify fileprocessing) . . . . . . . . . . . . . 921SET DRMINSTRPREFIX (Specify the prefix forrecovery instructions file names) . . . . . . 922SET DRMNOTMOUNTABLENAME (Specify thenot mountable location name) . . . . . . . 924SET DRMPLANPREFIX (Specify a prefix forrecovery plan file names) . . . . . . . . 925SET DRMPLANVPOSTFIX (Specify replacementvolume names) . . . . . . . . . . . . 927SET DRMPRIMSTGPOOL (Specify the primarystorage pools to be managed by DRM) . . . . 928SET DRMRPFEXPIREDAYS (Set criteria forrecovery plan file expiration) . . . . . . . 929SET DRMVAULTNAME (Specify the vaultname) . . . . . . . . . . . . . . . 931SET EVENTRETENTION (Set the retentionperiod for event records) . . . . . . . . 932SET INVALIDPWLIMIT (Set the number ofinvalid logon attempts) . . . . . . . . . 933SET LICENSEAUDITPERIOD (Set license auditperiod) . . . . . . . . . . . . . . 934SET MAXCMDRETRIES (Set the maximumnumber of command retries) . . . . . . . 935SET MAXSCHEDSESSIONS (Set maximumscheduled sessions) . . . . . . . . . . 936SET MINPWLENGTH (Set minimum passwordlength) . . . . . . . . . . . . . . 937SET PASSEXP (Set password expiration date) 938SET QUERYSCHEDPERIOD (Set query periodfor polling client nodes) . . . . . . . . . 940SET RANDOMIZE (Set randomization ofscheduled start times) . . . . . . . . . 941SET REGISTRATION (Set open or closedregistration) . . . . . . . . . . . . . 943SET RETRYPERIOD (Set time between retryattempts) . . . . . . . . . . . . . . 945SET SCHEDMODES (Select a central schedulingmode) . . . . . . . . . . . . . . . 946SET SERVERHLADDRESS (Set the high-leveladdress of a server) . . . . . . . . . . 948SET SERVERLLADDRESS (Set the low-leveladdress of a server) . . . . . . . . . . 949SET SERVERNAME (Specify the server name) 950SET SERVERPASSWORD (Set password forserver). . . . . . . . . . . . . . . 951SET SUBFILE (Set subfile backup for clientnodes) . . . . . . . . . . . . . . . 952SET SUMMARYRETENTION (Set number ofdays to keep data in activity summary table) . . 953SET TAPEALERTMSG (Set tape alert messageson or off) . . . . . . . . . . . . . . 954SET TOCLOADRETENTION (Set load retentionperiod for table of contents) . . . . . . . 955

SETOPT (Set a server option for dynamic update) 956

Contents vii

SHRED DATA (Shred data). . . . . . . . . 958SUSPEND EXPORT (Suspend a currently runningexport operation) . . . . . . . . . . . . 960UNLOCK commands. . . . . . . . . . . 961

UNLOCK ADMIN (Unlock an administrator) 962UNLOCK NODE (Unlock a client node) . . . 963UNLOCK PROFILE (Unlock a profile) . . . . 964

UPDATE commands . . . . . . . . . . . 965UPDATE ADMIN (Update an administrator) 966UPDATE BACKUPSET (Update a retentionvalue assigned to a backup set) . . . . . . 968UPDATE CLIENTOPT (Update a client optionsequence number) . . . . . . . . . . . 973UPDATE CLOPTSET (Update a client option setdescription) . . . . . . . . . . . . . 974UPDATE COLLOCGROUP (Update acollocation group) . . . . . . . . . . . 975UPDATE COPYGROUP (Update a copy group) 976UPDATE DATAMOVER (Update a data mover) 984UPDATE DEVCLASS (Update the attributes of adevice class) . . . . . . . . . . . . . 986UPDATE DOMAIN (Update a policy domain) 1053UPDATE DRIVE (Update a drive) . . . . . 1055UPDATE LIBRARY (Update a library) . . . . 1059UPDATE LIBVOLUME (Change the status of astorage volume) . . . . . . . . . . . 1064UPDATE MACHINE (Update machineinformation) . . . . . . . . . . . . 1066UPDATE MGMTCLASS (Update amanagement class) . . . . . . . . . . 1068UPDATE NODE (Update node attributes) . . 1071UPDATE NODEGROUP (Update a nodegroup) . . . . . . . . . . . . . . 1079UPDATE PATH (Change a path) . . . . . 1080UPDATE POLICYSET (Update a policy setdescription) . . . . . . . . . . . . 1085UPDATE PROFILE (Update a profiledescription) . . . . . . . . . . . . 1087UPDATE RECOVERYMEDIA (Update recoverymedia) . . . . . . . . . . . . . . 1088UPDATE SCHEDULE (Update a schedule) 1090UPDATE SCRIPT (Update a Tivoli StorageManager script) . . . . . . . . . . . 1110UPDATE SERVER (Update a server defined forserver-to-server communications) . . . . . 1112UPDATE SERVERGROUP (Update a servergroup description) . . . . . . . . . . 1116UPDATE SPACETRIGGER (Update the spacetriggers) . . . . . . . . . . . . . . 1117UPDATE STGPOOL (Update a storage pool) 1119UPDATE VIRTUALFSMAPPING (Update avirtual file space mapping) . . . . . . . 1153UPDATE VOLHISTORY (Update sequentialvolume history information) . . . . . . . 1155UPDATE VOLUME (Change a storage poolvolume) . . . . . . . . . . . . . . 1157

VALIDATE commands . . . . . . . . . . 1161VALIDATE LANFREE (Validate LAN-Freepaths) . . . . . . . . . . . . . . 1162VALIDATE POLICYSET (Verify a policy set) 1164

VARY (Bring a random access volume online oroffline) . . . . . . . . . . . . . . . 1166

Chapter 3. Server options . . . . . 1169Modifying server options . . . . . . . . . 1169Types of server options . . . . . . . . . . 1170

Communication options . . . . . . . . 1170Server storage options . . . . . . . . . 1171Client-server options . . . . . . . . . 1171Date, number, time, and language options . . 1172Database options . . . . . . . . . . . 1172Data transfer options . . . . . . . . . 1172Message options . . . . . . . . . . . 1173Event logging options . . . . . . . . . 1173Security options and licensing options. . . . 1173Miscellaneous options . . . . . . . . . 1174

3494SHARED . . . . . . . . . . . . . 1175ACSACCESSID . . . . . . . . . . . . 1176ACSLOCKDRIVE. . . . . . . . . . . . 1177ACSQUICKINIT . . . . . . . . . . . . 1178ACSTIMEOUTX . . . . . . . . . . . . 1179ACTIVELOGDIR . . . . . . . . . . . . 1180ACTIVELOGSIZE . . . . . . . . . . . 1181ADMINONCLIENTPORT . . . . . . . . . 1182AIXASYNCIO . . . . . . . . . . . . . 1183ALIASHALT . . . . . . . . . . . . . 1184ARCHFAILOVERLOGDIR. . . . . . . . . 1185ARCHIVELOGDIR . . . . . . . . . . . 1186ASSISTVCRRECOVERY . . . . . . . . . 1187AUDITSTORAGE . . . . . . . . . . . 1188COMMMETHOD. . . . . . . . . . . . 1189COMMTIMEOUT . . . . . . . . . . . 1190DBMEMPERCENT . . . . . . . . . . . 1191DEDUPREQUIRESBACKUP . . . . . . . . 1192DEVCONFIG . . . . . . . . . . . . . 1193DISABLESCHEDS . . . . . . . . . . . 1194DISKSTGPOOLMEMSIZE . . . . . . . . . 1194DISPLAYLFINFO. . . . . . . . . . . . 1195DNSLOOKUP . . . . . . . . . . . . . 1196DRIVEACQUIRERETRY . . . . . . . . . 1197EVENTSERVER . . . . . . . . . . . . 1198EXPINTERVAL . . . . . . . . . . . . 1199EXPQUIET . . . . . . . . . . . . . . 1200FILEEXIT . . . . . . . . . . . . . . 1201FILETEXTEXIT . . . . . . . . . . . . 1202IDLETIMEOUT . . . . . . . . . . . . 1203LANGUAGE . . . . . . . . . . . . . 1204MAXSESSIONS . . . . . . . . . . . . 1206MESSAGEFORMAT . . . . . . . . . . . 1207MIRRORLOGDIR . . . . . . . . . . . 1208MOVEBATCHSIZE . . . . . . . . . . . 1209MOVESIZETHRESH . . . . . . . . . . 1210MSGINTERVAL . . . . . . . . . . . . 1211NDMPCONTROLPORT . . . . . . . . . 1212NDMPPORTRANGE . . . . . . . . . . 1213NDMPPREFDATAINTERFACE . . . . . . . 1214NOPREEMPT . . . . . . . . . . . . . 1215NORETRIEVEDATE. . . . . . . . . . . 1216NUMOPENVOLSALLOWED. . . . . . . . 1217QUERYAUTH . . . . . . . . . . . . . 1219RECLAIMDELAY . . . . . . . . . . . 1220

viii IBM Tivoli Storage Manager for AIX: Administrators Reference

||

RECLAIMPERIOD . . . . . . . . . . . 1221REPORTRETRIEVE . . . . . . . . . . . 1222REQSYSAUTHOUTFILE . . . . . . . . . 1223RESOURCETIMEOUT . . . . . . . . . . 1224RESTOREINTERVAL . . . . . . . . . . 1225RETENTIONEXTENSION . . . . . . . . . 1226SANDISCOVERY. . . . . . . . . . . . 1227SANDISCOVERYTIMEOUT . . . . . . . . 1228SANREFRESHTIME . . . . . . . . . . . 1229SEARCHMPQUEUE. . . . . . . . . . . 1230SHMPORT . . . . . . . . . . . . . . 1231SHREDDING . . . . . . . . . . . . . 1232SNMPHEARTBEATINTERVAL . . . . . . . 1233SNMPMESSAGECATEGORY. . . . . . . . 1234SNMPSUBAGENT . . . . . . . . . . . 1235SNMPSUBAGENTHOST . . . . . . . . . 1236SNMPSUBAGENTPORT . . . . . . . . . 1237SSLTCPADMINPORT . . . . . . . . . . 1238SSLTCPPORT . . . . . . . . . . . . . 1239TCPADMINPORT . . . . . . . . . . . 1240TCPBUFSIZE . . . . . . . . . . . . . 1241TCPNODELAY . . . . . . . . . . . . 1242TCPPORT . . . . . . . . . . . . . . 1243TCPWINDOWSIZE . . . . . . . . . . . 1244TECBEGINEVENTLOGGING . . . . . . . 1245TECHOST . . . . . . . . . . . . . . 1246TECPORT . . . . . . . . . . . . . . 1247TECUTF8EVENT . . . . . . . . . . . . 1248THROUGHPUTDATATHRESHOLD . . . . . 1249THROUGHPUTTIMETHRESHOLD . . . . . 1250TXNGROUPMAX . . . . . . . . . . . 1251UNIQUETDPTECEVENTS . . . . . . . . 1252UNIQUETECEVENTS . . . . . . . . . . 1253USEREXIT . . . . . . . . . . . . . . 1254VERBCHECK . . . . . . . . . . . . . 1255VOLUMEHISTORY . . . . . . . . . . . 1256

Chapter 4. Server utilities. . . . . . 1257DSMSERV (Start the server) . . . . . . . . 1258The server startup script: rc.dsmserv . . . . . 1259DSMSERV DISPLAY DBSPACE (Displayinformation about database storage space) . . . 1260DSMSERV DISPLAY LOG (Display recovery loginformation) . . . . . . . . . . . . . 1261DSMSERV FORMAT (Format the database andlog) . . . . . . . . . . . . . . . . 1263DSMSERV INSERTDB (Move a server databaseinto an empty database) . . . . . . . . . 1265DSMSERV LOADFORMAT (Format a database) 1267DSMSERV REMOVEDB (Remove a database) 1269DSMSERV RESTORE DB (Restore the database) 1270

DSMSERV RESTORE DB (Restore a database toits most current state) . . . . . . . . . 1271DSMSERV RESTORE DB (Restore a database toa point-in-time) . . . . . . . . . . . 1273

DSMULOG (Capture a message to a user log file) 1276

Appendix A. Return codes for use inIBM Tivoli Storage Manager scripts . 1277

Appendix B. Accessibility featuresfor Tivoli Storage Manager . . . . . 1279

Notices . . . . . . . . . . . . . 1281Trademarks . . . . . . . . . . . . . 1283

Glossary . . . . . . . . . . . . . 1285

Index . . . . . . . . . . . . . . 1307

Contents ix

||

||

x IBM Tivoli Storage Manager for AIX: Administrators Reference

PrefaceIBM Tivoli Storage Manager is a client/server program that provides storagemanagement solutions to customers in a multi-vendor computer environment. IBMTivoli Storage Manager provides an automated, centrally scheduled,policy-managed backup, archive, and space-management facility for file serversand workstations.

Who should read this publicationThis reference is intended for anyone who is registered as an administrator. Asingle administrator can manage Tivoli Storage Manager, or several people canshare administrative responsibilities.

You should be familiar with the operating system on which the server resides andthe communication protocols required for the client/server environment. You alsoneed to understand the storage management practices of your organization, suchas how you are currently backing up workstation files and how you are usingstorage devices.

PublicationsTivoli Storage Manager publications and other related publications are availableonline.

You can search all publications in the Tivoli Storage Manager Information Center:http://publib.boulder.ibm.com/infocenter/tsminfo/v6.

You can download PDF versions of publications from the Tivoli Storage ManagerInformation Center or from the IBM Publications Center at http://www.ibm.com/shop/publications/order/.

You can also order some related publications from the IBM Publications CenterWeb site. The Web site provides information for ordering publications fromcountries other than the United States. In the United States, you can orderpublications by calling 800-879-2755.

Tivoli Storage Manager publicationsPublications are available for the server, storage agent, client, and Data Protection.

Table 1. Tivoli Storage Manager server publicationsPublication title Order number

IBM Tivoli Storage Manager Messages GC23-9787

IBM Tivoli Storage Manager Performance Tuning Guide GC23-9788

IBM Tivoli Storage Manager Problem Determination Guide GC23-9789

IBM Tivoli Storage Manager for AIX Installation Guide GC23-9781

IBM Tivoli Storage Manager for AIX Administrators Guide SC23-9769

IBM Tivoli Storage Manager for AIX Administrators Reference SC23-9775

IBM Tivoli Storage Manager for HP-UX Installation Guide GC23-9782

Copyright IBM Corp. 1993, 2009 xi

Table 1. Tivoli Storage Manager server publications (continued)Publication title Order number

IBM Tivoli Storage Manager for HP-UX Administrators Guide SC23-9770

IBM Tivoli Storage Manager for HP-UX Administrators Reference SC23-9776

IBM Tivoli Storage Manager for Linux Installation Guide GC23-9783

IBM Tivoli Storage Manager for Linux Administrators Guide SC23-9771

IBM Tivoli Storage Manager for Linux Administrators Reference SC23-9777

IBM Tivoli Storage Manager for Sun Solaris Installation Guide GC23-9784

IBM Tivoli Storage Manager for Sun Solaris Administrators Guide SC23-9772

IBM Tivoli Storage Manager for Sun Solaris Administrators Reference SC23-9778

IBM Tivoli Storage Manager for Windows Installation Guide GC23-9785

IBM Tivoli Storage Manager for Windows Administrators Guide SC23-9773

IBM Tivoli Storage Manager for Windows Administrators Reference SC23-9779

IBM Tivoli Storage Manager Server Upgrade Guide SC23-9554

IBM Tivoli Storage Manager for System Backup and Recovery Installationand Users Guide

SC32-6543

Table 2. Tivoli Storage Manager storage agent publicationsPublication title Order number

IBM Tivoli Storage Manager for SAN for AIX Storage Agent UsersGuide

SC23-9797

IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent UsersGuide

SC23-9798

IBM Tivoli Storage Manager for SAN for Linux Storage Agent UsersGuide

SC23-9799

IBM Tivoli Storage Manager for SAN for Sun Solaris Storage AgentUsers Guide

SC23-9800

IBM Tivoli Storage Manager for SAN for Windows Storage Agent UsersGuide

SC23-9553

Table 3. Tivoli Storage Manager client publicationsPublication title Order number

IBM Tivoli Storage Manager for UNIX and Linux: Backup-ArchiveClients Installation and Users Guide

SC23-9791

IBM Tivoli Storage Manager for Windows: Backup-Archive ClientsInstallation and Users Guide

SC23-9792

IBM Tivoli Storage Manager for Space Management for UNIX and Linux:Users Guide

SC23-9794

IBM Tivoli Storage Manager for HSM for Windows Administration Guide SC23-9795

IBM Tivoli Storage Manager Using the Application Program Interface SC23-9793

Program Directory for IBM Tivoli Storage Manager z/OS EditionBackup-Archive Client

GI11-8912

Program Directory for IBM Tivoli Storage Manager z/OS EditionApplication Program Interface

GI11-8911

xii IBM Tivoli Storage Manager for AIX: Administrators Reference

Table 4. Tivoli Storage Manager Data Protection publicationsPublication title Order number

IBM Tivoli Storage Manager for Advanced Copy Services: Data Protectionfor Snapshot Devices Installation and Users Guide

SC33-8331

IBM Tivoli Storage Manager for Databases: Data Protection for MicrosoftSQL Server Installation and Users Guide

SC32-9059

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle forUNIX and Linux Installation and Users Guide

SC32-9064

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle forWindows Installation and Users Guide

SC32-9065

IBM Tivoli Storage Manager for Enterprise Resource Planning: DataProtection for SAP Installation and Users Guide for DB2

SC33-6341

IBM Tivoli Storage Manager for Enterprise Resource Planning: DataProtection for SAP Installation and Users Guide for Oracle

SC33-6340

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Dominofor UNIX, Linux, and OS/400 Installation and Users Guide

SC32-9056

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Dominofor Windows Installation and Users Guide

SC32-9057

IBM Tivoli Storage Manager for Mail: Data Protection for MicrosoftExchange Server Installation and Users Guide

SC23-9796

Program Directory for IBM Tivoli Storage Manager for Mail (DataProtection for Lotus Domino)

GI11-8909

Related hardware publicationsThe following table lists related IBM hardware products publications.

For additional information on hardware, see the resource library for tape productsat http://www.ibm.com/systems/storage/tape/library.html.

Title Order Number

IBM TotalStorage 3494 Tape Library Introduction and Planning Guide GA32-0448

IBM TotalStorage 3494 Tape Library Operator Guide GA32-0449

IBM 3490E Model E01 and E11 Users Guide GA32-0298

IBM Tape Device Drivers Installation and Users Guide GC27-2130

IBM TotalStorage Enterprise Tape System 3590 Operator Guide GA32-0330

IBM TotalStorage Enterprise Tape System 3592 Operator Guide GA32-0465

Support informationYou can find support information for IBM products from a variety of sources.

Preface xiii

Getting technical trainingInformation about Tivoli technical training courses is available online.

Go to http://www.ibm.com/software/tivoli/education/.

Searching knowledge basesIf you have a problem with Tivoli Storage Manager, there are several knowledgebases that you can search.

You can begin with the Tivoli Storage Manager Information Center athttp://publib.boulder.ibm.com/infocenter/tsminfo/v6. From this Web site, youcan search all Tivoli Storage Manager publications.

Searching the InternetIf you cannot find an answer to your question in the Tivoli Storage Managerinformation center, search the Internet for the latest, most complete informationthat might help you resolve your problem.

To search multiple Internet resources, go to the support Web site for Tivoli StorageManager at http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html. From there, you can search a variety of resourcesincluding:v IBM technotesv IBM downloadsv IBM Redbooks

If you still cannot find the solution to the problem, you can search forums andnewsgroups on the Internet for the latest information that might help you resolveyour problem. To share your experiences and learn from others in the usercommunity, go to the Tivoli Storage Manager wiki at http://www.ibm.com/developerworks/wikis/display/tivolistoragemanager/Home.

Using IBM Support AssistantAt no additional cost, you can install on any workstation the IBM SupportAssistant, a stand-alone application. You can then enhance the application byinstalling product-specific plug-in modules for the IBM products that you use.

The IBM Support Assistant helps you gather support information when you needto open a problem management record (PMR), which you can then use to track theproblem. The product-specific plug-in modules provide you with the followingresources:v Support linksv Education linksv Ability to submit problem management reports

For more information, see the IBM Support Assistant Web site athttp://www.ibm.com/software/support/isa/.

xiv IBM Tivoli Storage Manager for AIX: Administrators Reference

Finding product fixesA product fix to resolve your problem might be available from the IBM SoftwareSupport Web site.

You can determine what fixes are available by checking the Web site:1. Go to the IBM Software Support Web site at http://www.ibm.com/software/

tivoli/products/storage-mgr/product-links.html.2. Click the Support Pages link for your Tivoli Storage Manager product.3. Click Download, and then click Fixes by version.

Getting e-mail notification of product fixesYou can get notifications about fixes and other news about IBM products.

To receive weekly e-mail notifications about fixes and other news about IBMproducts, follow these steps:1. From the support page for any IBM product, click My support in the

upper-right corner of the page.2. If you have already registered, skip to the next step. If you have not registered,

click Register in the upper-right corner of the support page to establish youruser ID and password.

3. Sign in to My support.4. On the My support page, click Edit profiles in the left navigation pane, and

scroll to Select Mail Preferences. Select a product family and check theappropriate boxes for the type of information you want.

5. Click Submit.6. For e-mail notification for other products, repeat steps 4 and 5.

Contacting IBM Software SupportYou can contact IBM Software Support if you have an active IBM softwaremaintenance contract and if you are authorized to submit problems to IBM.

Before you contact IBM Software Support, follow these steps:1. Set up a software maintenance contract.2. Determine the business impact of your problem.3. Describe your problem and gather background information.

Then see Submit the problem to IBM Software Support on page xvii forinformation on contacting IBM Software Support.

Setting up a software maintenance contractSet up a software maintenance contract. The type of contract that you needdepends on the type of product you have.v For IBM distributed software products (including, but not limited to, Tivoli,Lotus, and Rational products, as well as IBM DB2 and IBM WebSphere

products that run on Microsoft Windows or UNIX operating systems), enrollin IBM Passport Advantage in one of the following ways: Online: Go to the Passport Advantage Web page at http://www.ibm.com/

software/lotus/passportadvantage/, click How to enroll, and follow theinstructions.

By Phone: For the phone number to call in your country, go to the IBMSoftware Support Handbook Web page at http://www14.software.ibm.com/webapp/set2/sas/f/handbook/home.html and click Contacts.

Preface xv

v For server software products, you can purchase a software maintenanceagreement by working directly with an IBM sales representative or an IBMBusiness Partner. For more information about support for server softwareproducts, go to the IBM Technical support advantage Web page athttp://www.ibm.com/servers/.

If you are not sure what type of software maintenance contract you need, call1-800-IBMSERV (1-800-426-7378) in the United States. For a list of telephonenumbers of people who provide support for your location, go to the SoftwareSupport Handbook page at http://www14.software.ibm.com/webapp/set2/sas/f/handbook/home.html.

Determine the business impactWhen you report a problem to IBM, you are asked to supply a severity level.Therefore, you need to understand and assess the business impact of the problemyou are reporting.

Severity 1 Critical business impact: You are unable to use the program,resulting in a critical impact on operations. This conditionrequires an immediate solution.

Severity 2 Significant business impact: The program is usable but isseverely limited.

Severity 3 Some business impact: The program is usable with lesssignificant features (not critical to operations) unavailable.

Severity 4 Minimal business impact: The problem causes little impact onoperations, or a reasonable circumvention to the problem hasbeen implemented.

Describe the problem and gather background informationWhen explaining a problem to IBM, it is helpful to be as specific as possible.Include all relevant background information so that IBM Software Supportspecialists can help you solve the problem efficiently.

To save time, know the answers to these questions:v What software versions were you running when the problem occurred?v Do you have logs, traces, and messages that are related to the problemsymptoms? IBM Software Support is likely to ask for this information.

v Can the problem be recreated? If so, what steps led to the failure?v Have any changes been made to the system? For example, hardware, operatingsystem, networking software, and so on.

v Are you currently using a workaround for this problem? If so, be prepared toexplain it when you report the problem.

xvi IBM Tivoli Storage Manager for AIX: Administrators Reference

Submit the problem to IBM Software SupportYou can submit the problem to IBM Software Support online or by phone.

OnlineGo to the IBM Software Support Web site at http://www.ibm.com/software/support/probsub.html. Enter your information into theappropriate problem submission tool.

By phoneFor the phone number to call in your country, go to the contacts page ofthe IBM Software Support Handbook at http://www14.software.ibm.com/webapp/set2/sas/f/handbook/home.html.

If the problem that you submit is for a software defect or for missing or inaccuratedocumentation, IBM Software Support creates an Authorized Program AnalysisReport (APAR). The APAR describes the problem in detail. If a workaround ispossible, IBM Software Support provides one for you to implement until the APARis resolved and a fix is delivered. IBM publishes resolved APARs on the TivoliStorage Manager product support Web site at http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html, so that users whoexperience the same problem can benefit from the same resolutions.

Conventions used in this publicationv Command to be entered on the AIX command line:

> dsmadmc

v Command to be entered on the command line of an administrative client:query devclass

In the usage and descriptions for administrative commands, the term characterscorresponds to the number of bytes available to store an item. For languages inwhich it takes a single byte to represent a displayable character, the character tobyte ratio is 1 to 1. However, for DBCS and other multi-byte languages, thereference to characters refers only to the number of bytes available for the item andmay represent fewer actual characters.

Preface xvii

xviii IBM Tivoli Storage Manager for AIX: Administrators Reference

New for IBM Tivoli Storage Manager Version 6.1Many features in the Tivoli Storage Manager Version 6.1 server are new forprevious Tivoli Storage Manager users.

New for the server in Version 6.1.2Server fix pack 6.1.2 contains several new features, in addition to fixes forproblems.

Enabled functionsFunctions that were disabled in Tivoli Storage Manager V6.1.0 and V6.1.1 are nowenabled in Version 6.1.2.

Until Tivoli Storage Manager V6.1.2, a database that contained backup sets ortables of contents (TOCs) could not be upgraded to V6. These restrictions nolonger exist.

In addition, the following commands have been enabled in Version 6.1.2:v BACKUP NAS client command if the TOC parameter specifies PREFERRED orYES

v BACKUP NODE if the TOC parameter specifies PREFERRED or YESv DEFINE BACKUPSETv GENERATE BACKUPSETv GENERATE BACKUPSETTOC

Licensing changesFollowing the release of Tivoli Storage Manager Version 6.1.2, Tivoli StorageManager Version 6.1.0 will no longer be available for download or purchase. Dueto this unique circumstance, certain 6.1.2 packages will be available with a licensemodule. See the following information for details on how this situation affects yourenvironment.

Existing Version 6.1.0 and 6.1.1 usersIf you have installed version 6.1.0 and are using a version 6.1.0 license, youcan download the 6.1.2 package from the Service FTP site. You can installthe 6.1.2 package using the instructions in Installing a Tivoli StorageManager fix pack.

Version 5 usersIf you have not yet installed a version of the V6.1 server, when youupgrade, you must upgrade directly to version 6.1.2. Version 6.1.2 isavailable with a license module from Passport Advantage or from yourTivoli Storage Manager sales representative. You can upgrade from V5 toV6.1.2 using the instructions in Upgrading the server.

New usersVersion 6.1.2 is available from Passport Advantage or from your TivoliStorage Manager sales representative. You can install version 6.1.2 usingthe instructions in Installing Tivoli Storage Manager.

Copyright IBM Corp. 1993, 2009 xix

|||

|||||||||||||

||||||||||||||||||||||

TSMDLST utility for AIXThe tsmdlst utility is now available for AIX beginning in Tivoli Storage Managerfix pack level 6.1.2.

Use the tsmdlst utility to obtain information for AIX operating systems aboutmedium-changer, tape, and optical devices controlled by the Tivoli StorageManager device driver. With this utility you can obtain usage information, devicenames, serial numbers, and other device information.

Device support for AIXThe number of devices per driver is extended for AIX.

The Tivoli Storage Manager device driver can configure 1024 devices for eachdriver.

PREVIEW parameter for DSMSERV INSERTDBA PREVIEW parameter is available for the DSMSERV INSERTDB utility in TivoliStorage Manager fix pack level 6.1.2. The DSMSERV INSERTDB utility is used onlyas part of the process for upgrading a V5 Tivoli Storage Manager server to V6.1.

When you use the PREVIEW=YES parameter, the operation includes all the stepsof the process, except for the actual insertion of data into the new database.

When you preview the insertion operation, you can quickly verify that the sourcedatabase is readable. You can also identify any data constraint violations beforeyou run the actual upgrade process for your server.

New server option SANDISCOVERYTIMEOUTA new server option is available for SAN discovery functions beginning in TivoliStorage Manager fix pack level 6.1.2.

The SANDISCOVERYTIMEOUT option specifies the amount of time allowed forhost bus adapters to respond when they are queried by the SAN discovery process.Related reference

SANDISCOVERYTIMEOUT on page 1228The SANDISCOVERYTIMEOUT option specifies the amount of time allowed forhost bus adapters to respond when they are queried by the SAN discovery process.Once the time specified for the SANDISCOVERYTIMEOUT is reached, the processtimes out.

New for the server in Version 6.1.0Tivoli Storage Manager server version 6.1.0 contains many new features andchanges.

Functions enabled in the V6.1.2 server

xx IBM Tivoli Storage Manager for AIX: Administrators Reference

|||||||

||||

|||||||||

|||||||||||

Disabled functions in 6.1.0 and 6.1.1Some functions have been disabled in Tivoli Storage Manager 6.1.0 and 6.1.1.

Note: The restrictions described here have been removed in Tivoli Storage Manager V6.1.2.If your server is at the V6.1.0 or V6.1.1 level, migrate to V6.1.2 to enable these functions.

A database containing backup sets or tables of contents (TOCs) cannot beupgraded to V6.1.0 or 6.1.1. The database upgrade utilities check for definedbackup sets and existing TOCs. If either exists, the upgrade stops and a message isissued saying that the upgrade is not possible at the time. In addition, anyoperation on a V6.1 server that tries to create or load a TOC fails.

When support is restored by a future V6.1 fix pack, the database upgrade and allbackup set and TOC operations will be fully enabled.

In the meantime, the following commands have been disabled:v BACKUP NAS client command if the TOC parameter specifies PREFERRED orYES

v BACKUP NODE if the TOC parameter specifies PREFERRED or YESv DEFINE BACKUPSETv GENERATE BACKUPSETv GENERATE BACKUPSETTOC

Changes to the Version 6.1 Administration CenterMany features in the Tivoli Storage Manager Administration Center Version 6.1 arenew for previous users.

Updated Integrated Solutions Console

In V6.1, the Administration Center is hosted by the IBM Integrated SolutionsConsole (ISC) Advanced Edition Version 7.1. After installation of the IntegratedSolutions Console installation completes, open a Web browser and enter thefollowing URL, which will display the logon screen for the Integrated SolutionsConsole: https://local_host:9043/ibm/console. This screen indicates a successfulinstallation of the Integrated Solutions Console.

To learn about console updates:1. Start the ISC.2. Click Help in the ISC banner.3. In the Help navigation tree, click Console Updates.

Identify managing servers

The table of servers that is the hub of the enterprise-management work page has acolumn that identifies the managing server, if one exists, for each listed server. Bysorting or filtering on the column, you can display the set of servers that aremanaged by a given server.

Hover help for table links

The Administration Center typically displays Tivoli Storage Manager objects in atable. In V6.1, when the cursor hovers over an object image, hover-help text is


New for IBM Tivoli Storage Manager Version 6.1 xxi

||||||||||||||||||||

displayed. The hover help identifies the default action that results when you clickthe link that is associated with the object.

Links to information about server messages and AdministrationCenter messages

When a problem or issue occurs with the server or Administration Center, you areimmediately notified and provided with a brief message about the problem orissue. The message number is also provided. In V6.1, you can obtain detailedinformation about a message by clicking the link that is associated with themessage number. The information is displayed in a new browser window.

Maintenance script enhancements

Tivoli Storage Manager utilizes a maintenance script to perform scheduledmaintenance tasks. In V6.1, you can generate a maintenance script in one of twostyles: predefined and custom.

A predefined maintenance script is one that is generated through a wizard. Thisscript contains standard commands that cannot be altered. A predefined script canonly be modified in the wizard.

A custom maintenance script is created using the Administration Centermaintenance script editor. To have more control of your maintenance tasks, youcan modify the commands that you specify. You can also use the editor to updateyour custom maintenance script.

Client nodes and backup sets enhancements

The redesigned Administration Center displays information about backup sets,client nodes, and client-node groups in one portlet. The design includes searchfunctions that you can use to find and display information more quickly. Whenyou select a client node, a summary panel is displayed with the current operationstatus, server actions, and client-node actions.

The work item Client nodes and backup sets appears in the ISC navigation tree.

Session and process information available in the health monitor

The Administration Center health monitor now includes information about serverprocesses and sessions. The information is also available in the propertiesnotebooks for servers.

Centralized server-connection management

In V6.1, server-connection tasks, such as adding a server connection, changing apassword, and creating a server instance, are consolidated in a single location: theManage Servers work item, located in the ISC navigation tree.

With actions available in this work item, you can quickly upload server-connectioninformation to the Administration Center using an XML file. This file canoptionally include a set of server credentials for multiple servers. To help create anXML file, you can download a list of server connections, without the credentialinformation.


xxii IBM Tivoli Storage Manager for AIX: Administrators Reference

Changes to management-class activation

In the V6.1, Tivoli Storage Manager no longer activates changes to existingmanagement classes automatically. You must activate the changes manually. Beforethe changes take effect, they are validated. Results of the validation are displayed.You or another administrator can review them, and then either confirm or cancelthe activation.

Because changes are manually activated, you can prepare the management class inadvance and activate the changes at an appropriate time.

Data deduplicationData deduplication is a method of eliminating redundant data in sequential-accessdisk (FILE) primary, copy, and active-data storage pools. One unique instance ofthe data is retained on storage media, and redundant data is replaced with apointer to the unique data copy. The goal of deduplication is to reduce the overallamount of time that is required to retrieve data by letting you store more data ondisk, rather than on tape.

Data deduplication in Tivoli Storage Manager is a two-phase process. In the firstphase, duplicate data is identified. During the second phase, duplicate data isremoved by certain server processes, such as reclamation processing ofstorage-pool volumes. By default, a duplicate-identification process beginsautomatically after you define a storage pool for deduplication. (If you specify aduplicate-identification process when you update a storage pool, it also startsautomatically.) Because duplication identification requires extra disk I/O and CPUresources, Tivoli Storage Manager lets you control when identification begins aswell as the number and duration of processes.

You can deduplicate any type of data except encrypted data. You can deduplicateclient backup and archive data, Tivoli Data Protection data, and so on. TivoliStorage Manager can deduplicate whole files as well as files that are members ofan aggregate. You can deduplicate data that has already been stored. No additionalbackup, archive, or migration is required.

For optimal efficiency when deduplicating, upgrade to the version 6.1backup-archive client.

Restriction: You can use the data-deduplication feature with Tivoli StorageManager Extended Edition only.


New for IBM Tivoli Storage Manager Version 6.1 xxiii

Related reference

DEDUPREQUIRESBACKUP on page 1192The DEDUPREQUIRESBACKUP option specifies whether volumes in primarysequential-access storage pools that are set up for deduplication can be reclaimedand whether duplicate data can be discarded before the storage pools are backedup.DEFINE STGPOOL (Define a primary storage pool assigned to sequential accessdevices) on page 302Use this command to define a primary storage pool assigned to sequential accessdevices.DEFINE STGPOOL (Define a copy storage pool assigned to sequential accessdevices) on page 317Use this command to define a copy storage pool assigned to sequential accessdevices.DEFINE STGPOOL (Define an active-data pool assigned to sequential-accessdevices) on page 325Use this command to define an active-data pool assigned to sequential-accessdevices.IDENTIFY DUPLICATES (Identify duplicate data in a storage pool) on page 497Use this command to start or stop processes that identify duplicate data in astorage pool. You can specify the number of duplicate-identification processes andtheir duration.QUERY PROCESS (Query one or more server processes) on page 736Use this command to display information on active background processes.QUERY STGPOOL (Query storage pools) on page 788Use this command to display information about one or more storage pools. Youcan also use this command to monitor migration processes for the storage pool.UPDATE STGPOOL (Update a primary sequential access pool) on page 1128Use this command to update a primary sequential access storage pool.UPDATE STGPOOL (Update a copy sequential access storage pool) on page 1141Use this command to update a copy sequential access storage pool.UPDATE STGPOOL (Update an active-data sequential access) on page 1147Use this command to update an active-data pool.

Storage devicesNew device support and other changes to storage devices are available in TivoliStorage Manager Version 6.1.

Support for HP and Quantum DAT160 drives and mediaWith Tivoli Storage Manager, you can now use HP and Quantum DAT160 (DDS6)tape drives and media. New recording formats are available for the 4MM devicetype.Related reference

DEFINE DEVCLASS (Define a 4MM device class) on page 152Use the 4MM device class when you are using 4 mm tape devices.UPDATE DEVCLASS (Update a 4MM device class) on page 998Use the 4MM device class when you are using 4 mm tape devices.


xxiv IBM Tivoli Storage Manager for AIX: Administrators Reference

Support for Sun StorageTek T10000 drives, T10000B drives, andT10000 mediaWith Tivoli Storage Manager, you can now use Sun StorageTek T10000 drives,T10000B drives, and T10000 media. New recording formats are available for theECARTRIDGE device type. Tivoli Storage Manager supports Volsafe media withthe Sun StorageTek T10000 and T10000B drives.Related reference

DEFINE DEVCLASS (Define an ECARTRIDGE device class) on page 177Use the ECARTRIDGE device class when you are using StorageTek drives such asthe StorageTek SD-3, 9490, 9840 or 9940.UPDATE DEVCLASS (Update an ECARTRIDGE device class) on page 1020Use the ECARTRIDGE device class when you are using StorageTek drives such asthe StorageTek SD-3, 9490, 9840 or 9940.

Disaster recovery manager support for active-data poolsTo restore your client systems more quickly and efficiently, you can now useactive-data pools in your recovery plans and procedures.

Active-data pools are storage pools that contain only active versions of clientbackup data. Like copy storage pool volumes, disaster recovery manager lets you:v Specify the names of active-data pool volumes to be managed by the disasterrecovery manager.

v Recycle on-site and off-site active-data pool volumes according to server policiesand processes.

v Include active-data pool volumes in the scripts, macros, and documentation thatis part of the recovery plan file.

v Track and manage active-data pool media as required by your operations.

By default, active-data pools are not eligible for processing at the time ofinstallation. Copy storage pools, on the other hand, are processed at installationtime even if you have not explicitly specified a copy storage pool or pools to bemanaged.


New for IBM Tivoli Storage Manager Version 6.1 xxv

Related reference

MOVE DRMEDIA (Move disaster recovery media offsite and back onsite) onpage 544Use this command to track database backup and copy storage pool volumes thatare to be moved offsite and to identify the expired or empty volumes that are to bemoved onsite.PREPARE (Create a recovery plan file) on page 580Use this command to create a recovery plan file, which contains the informationneeded to recover a Tivoli Storage Manager server. You can store a recovery planfile on a file system that is accessible to the source Tivoli Storage Manager serveror on a target Tivoli Storage Manager server.QUERY DRMEDIA (Query disaster recovery media) on page 645Use this command to display information about database backup and copy storagepool volumes. You can also use the command to create a file of executablecommands to process the volumes.QUERY DRMSTATUS (Query disaster recovery manager system parameters) onpage 654Use this command to display information about the system parameters defined fordisaster recovery manager (DRM).SET DRMACTIVEDATASTGPOOL (Specify the active-data pools to be managedby DRM) on page 913Use this command to specify names of the active-data pools to be recovered after adisaster. Tivoli Storage Manager uses these names if the PREPARE , MOVEDRMEDIA, or QUERY DRMEDIA command does not include theACTIVEDATASTGPOOL parameter.

EXPIRE INVENTORY command enhancementsThe EXPIRE INVENTORY command is now enhanced with new functionality.

The additional parameters that you can now use are NODE, DOMAIN, TYPE,DURATION, AND RESOURCE. You can use these parameters to target specificclient nodes and domains, and also to determine the type of data to be processed.You can use the RESOURCE parameter to specify the number of parallel processesthat you want to run within the single EXPIRE INVENTORY process. You can runup to ten threads at one time, but if you are processing one node, only one threadis utilized.Related reference

EXPIRE INVENTORY (Manually start inventory expiration processing) on page424Use this command to manually start inventory expiration processing. Theinventory expiration process removes client backup and archive file copies fromserver storage based on policy specified in the backup and archive copy groups ofthe management classes to which the files are bound.


xxvi IBM Tivoli Storage Manager for AIX: Administrators Reference

No-query restore changesThe no-query restore (NQR) function and the internal algorithms responsible forNQR were changed to take advantage of DB2 capabilities and to improveperformance.

The NQR function has been rewritten to resolve a performance problemencountered when restoring a small number of objects for a client file system witha large number of backup objects spread across a large number of Tivoli StorageManager server storage pool volumes. NQR performance is now comparable tothat of the classic restore under these conditions. NQR now performs a volumedetermination phase that must be completed before any objects are restored fromDISK, FILE, or tape storage volumes.

Server databaseTivoli Storage Manager version 6.1 provides a new server database. Advantagesinclude automatic statistics collection and database reorganization, full-functionSQL queries, and elimination of the need for offline audits of the database.

Upgrading to V6.1 requires that data in a current Tivoli Storage Manager serverdatabase be extracted and then inserted into the new database structure. TivoliStorage Manager provides utilities to perform the process.

Support for NetApp SnapMirror to Tape featureWith Tivoli Storage Manager you can create SnapMirror to Tape images of filesystems on NetApp file servers.

SnapMirror to Tape provides an alternative method for backing up very largeNetApp file systems. Because this backup method has limitations, use this methodwhen copying very large NetApp file systems to secondary storage for disasterrecovery purposes.Related reference

BACKUP NODE (Back up a NAS node) on page 49Use this command to start a backup operation for a network-attached storage(NAS) node.RESTORE NODE (Restore a NAS node) on page 866Use this command to initiate a restore operation for a network-attached storage(NAS) node.QUERY NASBACKUP (Query NAS backup images) on page 708Use this command to display information about the file system image objects thathave been backed up for a specific NAS node and file space. You can only use thiscommand to display objects that were backed up for a NAS node using NDMP.

Reporting and monitoring featureThe reporting and monitoring feature uses a combination of the Tivoli CommonReporting tool, IBM Tivoli Monitoring, and the IBM Tivoli Data Warehouse to offeryou reports and real time monitoring information about Tivoli Storage Managerservers and client activity.


New for IBM Tivoli Storage Manager Version 6.1 xxvii

ODBC driver supportTivoli Storage Manager Version 6.1 uses the DB2 open database connectivity(ODBC) driver to query the database and display the results.

The Tivoli Storage Manager ODBC driver is no longer supported with the server.

Backup sets and client node enhancementsThe Administration Center now displays the backup sets, client nodes, and clientnode groups from one portlet.

You can view all of the client nodes, view them by server, or search for a nodefrom the three available client node tabs. The All Client Nodes tab lists all of thenodes and has a Filter feature to help in your search. The filter works differentlythan the other table filters in the Administration Center, in that here you do nothave to press the Enter key to get results. The search is initiated when you enter atext character in the filter field. As you add characters, the results are filtered evenmore.

When you select a client node, a summary panel is displayed with the currentoperation status, server actions, and client node actions. You can also access theServer Actions by right-clicking on the selected row.

The Search tab lets you refine your search parameters to include the server name,the client node name, policy domain name, and other fields that are available.

In the Client Node Groups section, you can find a client node group from the AllClient Node Groups tab or from the By Server tab. You can use the filter and theright-click menu on these pages also.

Backup sets are found in the Backup Set Collections section. Search a server byselecting it and clicking Update Table.


xxviii IBM Tivoli Storage Manager for AIX: Administrators Reference

Command and option changesUse the lists of new, changed, and deleted commands and options to help youidentify operation changes that are needed for your server.

New server commands, utilities, and optionsNew commands, utilities, and options are available for the V6.1 server because ofchanges in database operations and new functions.

New commandsNew utilitiesNew server options on page xxx

New commandsTable 5. New commands

Command FunctionComparable commandsin previous versions

EXTEND DBSPACE Makes additional storage space available for the serverto use for its database.

You can have multiple locations for the databasestorage space. After installation and initial use ofDSMSERV FORMAT or DSMSERV LOADFORMAT,you can add more locations for the storage space forthe database.

DEFINE DBVOLUME

EXTEND DB

IDENTIFY DUPLICATES Starts or stops processes that identify duplicate data ina storage pool.

None

QUERY DBSPACE Displays the current locations for the database storage,along with total space, and used space.

QUERY DBVOLUME

SET DBRECOVERY Sets the device class to use for backup of the serversdatabase. The database manager uses the device classfor automatic backups of the database.

DEFINEDBBACKUPTRIGGER

SET DBREPORTMODE Sets the amount of diagnostic information that isreported for the database.

None

SETDRMACTIVEDATASTGPOOL

Sets the active-data pools that are included in yourrecovery plans and procedures.

None

New utilitiesTable 6. New utilities


DSMSERV DISPLAY DBSPACE Offline utility to view the current locations fordatabase storage.

DSMSERV DISPLAYDBVOLUMES

DSMSERV DISPLAY LOG Offline utility to view information about the recoverylogs (active log and archive logs).

DSMSERV DISPLAYLOGVOLUMES

DSMSERV INSERTDB Offline utility used only for inserting data that hasbeen extracted from a V5 server database into anempty V6.1 database.

None

Copyright IBM Corp. 1993, 2009 xxix

Table 6. New utilities (continued)


DSMSERV REMOVEDB Offline utility used only when you are sure that youno longer need a servers database and recovery logs.Use with caution.

None

DSMUPGRD PREPAREDB Offline utility used only on a V5 server to prepare thedatabase for extraction. After this utility is run, thedata can be extracted from the database using theDSMUPGRD EXTRACTDB utility. This is one of theupgrade utilities.

None

DSMUPGRD EXTRACTDB Offline utility used only on a V5 server to extract thedata from the database. The extracted data is insertedinto a V6.1 database using the DSMSERV INSERTDButility. This is one of the upgrade utilities.

None

DSMUPGRD EXTEND DB Offline utility used only on a V5 server to extend thedatabase when database space is insufficient tosuccessfully complete the upgrade process. This is oneof the upgrade utilities.

None

DSMUPGRD EXTEND LOG Offline utility used only on a V5 server to extend therecovery log when recovery log space is insufficient tosuccessfully complete the upgrade process. This is oneof the upgrade utilities.

None

DSMUPGRD QUERYDB Offline utility used only on a V5 server to displayinformation about the database and recovery log. Thisis one of the upgrade utilities.

None

New server optionsTable 7. New server options. For some options, changes have no effect until the server is restarted.

New server option Function

Comparablecommands or optionsin previous versions

ACTIVELOGDIR The new directory for the location where the active logis stored. Use this option to change the location of theactive log.

The location is originally specified during installation.There is only one location for the active log.

DEFINELOGVOLUME

ACTIVELOGSIZE The maximum size of the active log. EXTEND LOG

REDUCE LOG

ARCHFAILOVERLOGDIR The directory in which the server stores archive logfiles if they cannot be stored in the archive loglocation.

None

ARCHIVELOGDIR The directory in which the server stores the archivelog.

None

DBMEMPERCENT Sets a limit on the percentage of the system memorythat is used for the database.

None

DEDUPREQUIRESBACKUP Control for backup operations for primarysequential-access storage pools that are set up fordeduplication.

None

xxx IBM Tivoli Storage Manager for AIX: Administrators Reference

|

Table 7. New server options (continued). For some options, changes have no effect until the server is restarted.

New server option Function

Comparablecommands or optionsin previous versions

DISKSTGPOOLMEMSIZE The size of the cache that the server can use tomanage operations for storage pools with the devicetype of DISK.

None

MIRRORLOGDIR The directory where the log mirror for the active log isstored.

DEFINE LOGCOPY

AIX, HP-UX, Linux, and SunSolaris systems:SANDISCOVERYTIMEOUT

The amount of time that is allowed for host busadapters to respond when they are queried by theSAN discovery process.

None

Updated server commands, utilities, and optionsCommands, utilities, and options are updated for V6.1 because of changes indatabase operations and other new functions.

Updated commandsUpdated utilities on page xxxiiUpdated server options on page xxxiii

Updated commandsTable 8. Updated commandsCommand Changes

BACKUP DB The SET DBRECOVERY command must berun first to set a device class for databasebackups.

An incremental database backup is now abackup of all changes since the last fullbackup. In earlier versions of the server, anincremental backup was a backup of allchanges since either the last full backup orthe last incremental backup.

BACKUP NODERESTORE NODEQUERY NASBACKUP

The commands support creating SnapMirrorto Tape images of file systems on NetAppfile servers.

BACKUP VOLHISTORYDELETE VOLHISTORYQUERY VOLHISTORYUPDATE VOLHISTORY

Database dump operations are no longeravailable, therefore database dump volumesdo not appear in the volume history. Queryoutput is changed.

DEFINE DEVCLASSUPDATE DEVCLASS

Device formats have been added for someoperating systems.

DEFINE SPACETRIGGERDELETE SPACETRIGGERQUERY SPACETRIGGERUPDATE SPACETRIGGER

The space trigger commands now supportspace triggers only for storage pools. Thedatabase and log space triggers are nolonger available.

DEFINE STGPOOLQUERY STGPOOLUPDATE STGPOOL

The storage pool commands support thedata deduplication functions.

DEFINE VOLUME The maximum capacity of a volume in aDISK storage pool is 8 TB.

Command and option changes xxxi

|||

Table 8. Updated commands (continued)Command Changes

EXPIRE INVENTORY Expiration can be run for specific nodes andnode groups, or for all nodes in a policydomain. The types of data to be examinedfor expiration can also be specified.

GRANT AUTHORITYREVOKE AUTHORITY

ANALYST privilege class is removed.

HALT The QUIESCE parameter is no longerneeded.

MOVE DRMEDIAPREPAREQUERY DRMEDIAQUERY DRMSTATUS

Changes to disaster recovery managercommands allow you to include active-datapools in your recovery plans andprocedures.

QUERY DB Output is changed.

QUERY LOG Output is changed.

QUERY OPTION Obsolete options are removed from theoutput.

QUERY PROCESS Information about duplicate identificationprocesses is available through thiscommand.

QUERY SESSION A new field in the output indicates theactions that occurred during the session.

QUERY STATUS Output is changed. Obsolete options areremoved, and the database backup trigger isremoved.

SELECT Some parameters that were previouslyallowed might cause errors. SQL parameterusage must now conform to usage that isacceptable to the database manager. SeeChanges to the SELECT command onpage xxxvii.

SETOPT Obsolete options are removed.

UPDATE ADMIN ANALYST privilege class is removed.

Updated utilitiesTable 9. Updated utilitiesUtility Changes

DSMSERV (starting the server) New options are available for specifying theowning user ID for the server instance onstartup. The new options are also availablefor other DSMSERV utilities.

DSMSERV FORMAT Obsolete parameters are removed. Newparameters are added to specify thedirectories for database space, and themaximum size and locations of the recoverylog.

This utility is used to format a database forinstallation of a new server.

xxxii IBM Tivoli Storage Manager for AIX: Administrators Reference

Table 9. Updated utilities (continued)Utility Changes

DSMSERV LOADFORMAT This utility is used only for formatting anew, completely empty database. An emptydatabase is used only as part of the processof upgrading an earlier version of the serverto V6.1. After you format an emptydatabase, you use the DSMSERV INSERTDButility to insert data that was extracted fromthe database of an earlier version of theserver.

DSMSERV RESTORE DB

v Restore a database to its most currentstate

v Restore a database to a point in time

Volume history is now required for restoringthe database.

All restore operations use roll-forwardrecovery.

The function for restoring individualdatabase volumes was removed. The serverno longer manages database volumes.

Updated server optionsTable 10. Updated server optionsOption Changes

TXNGROUPMAX The default value is increased from 256 to4096. Check whether the server options filehas this option:

v If the server options file does not includethis option, the server automatically usesthe new default value.

v If the server options file includes a valuefor the option, the server uses thatspecified value. If the specified value isless than 4096, consider increasing thisvalue, or removing the option so that theserver uses the new default value.Increasing the value or using the newdefault value can improve theperformance for data movementoperations such as storage pool migrationand storage pool backup.

Increasing the value for theTXNGROUPMAX option has no effect ondata-movement performance for files thatwere stored on the server using a lowervalue for the option.

Command and option changes xxxiii

Deleted server commands, utilities, and optionsSome commands, utilities, and options are deleted because their function is nolonger needed. In some cases, new commands replace deleted commands.

Deleted commandsDeleted utilities on page xxxvDeleted server options on page xxxvi

Deleted commandsTable 11. Deleted commandsDeleted command Comments

CONVERT ARCHIVE The operation that this command performedis no longer needed.

DEFINE DBBACKUPTRIGGERDELETE DBBACKUPTRIGGERQUERY DBBACKUPTRIGGERUPDATE DBBACKUPTRIGGER

Ensure that you schedule backups of thedatabase to occur at least once per day.

DEFINE DBCOPY Database volumes are no longer used.

DEFINE DBVOLUMEQUERY DBVOLUME

Space allocation is done automatically in thedirectory locations specified for the database.

DEFINE LOGCOPY Instead of log volume copies, you canspecify a log mirror to have the active logprotected by a mirror copy.

DEFINE LOGVOLUMEDELETE LOGVOLUMEQUERY LOGVOLUME

The database manager automaticallymanages space in the recovery logdirectories.

For information about the directories thatare used for the logs, use the QUERY LOGcommand.

ESTIMATE DBREORGSTATS Collecting and resetting database statisticsoccurs automatically.

Database-reorganization operations are doneautomatically by the database manager asneeded.

EXTEND DB Space allocation is done automatically in thedirectory locations specified for the database.If the server needs additional space, you canadd directory locations by using theEXTEND DBSPACE command.

EXTEND LOG Server options are available for increasingthe size of recovery logs.

QUERY SQLSESSION The information that this command suppliedis no longer in the server database. SQLSELECT settings are replaced by syntaxoptions that are available in a DB2 SELECTcommand.

REDUCE DB Space allocation is done automatically in thedirectory locations specified for the database.You cannot adjust the assigned capacity ofthe database.

xxxiv IBM Tivoli Storage Manager for AIX: Administrators Reference

Table 11. Deleted commands (continued)Deleted command Comments

REDUCE LOG The database manager automaticallymanages space in the recovery logdirectories.

RESET BUFPOOL The BUFPOOLSIZE option has beeneliminated, therefore this command is notneeded.

RESET DBMAXUTILIZATIONRESET LOGCONSUMPTIONRESET LOGMAXUTILIZATION

Collecting and resetting database statisticsoccurs automatically.

SET LOGMODE Logging mode for the database is nowalways roll-forward mode.

SET SQLDATETIMEFORMATSET SQLDISPLAYMODESET SQLMATHMODE

The commands are replaced by options inthe DB2 SELECT command syntax.

UNDO ARCHCONVERSION The operation that this command performedis no longer needed.

UPDATE ARCHIVE The operation that this command performedis no longer needed.

Deleted utilitiesTable 12. Deleted utilitiesDeleted utility Comments

DSMFMT Space allocation is done automatically in thedirectory locations specified for the database.

DSMSERV AUDITDB Offline database audits are no longerrequired.

As data is added to the server database, thedatabase manager automatically checks dataconstraints and data types. The onlineintegrity checks prevent problems for whichoffline audits had been needed in earlierreleases.

DSMSERV DISPLAY DBBACKUPVOLUME Information about volumes used fordatabase backup is available from thevolume history file. The volume history fileis now required to restore the database.

DSMSERV DISPLAY DBVOLUMES Use DSMSERV DISPLAY DBSPACE to viewinformation about database space when theserver is not running.

DSMSERV DISPLAY LOGVOLUMES Use DSMSERV DISPLAY LOG to displayinformation about recovery logs includingthe active log, the mirror for the active log,the failover directory for the archive log, andthe overflow location for logs.

DSMSERV DUMPDB The operation that this utility performed isno longer needed.

Command and option changes xxxv

Table 12. Deleted utilities (continued)Deleted utility Comments

DSMSERV EXTEND LOG This utility is replaced by the followingserver options:

ACTIVELOGSIZE

ACTIVELOGDIR

MIRRORLOGDIR

With these options, you can add recoverylog space if the log is full when the server isdown.

DSMSERV LOADDB The operation that this utility performed isno longer needed.

DSMSERV RESTORE DB

Restore a single database volume to itsmost current state

Restore a database to a point in timewhen a volume history file is unavailable

The server does not track individualdatabase volumes in V6.1.

The volume history file is required toperform database restore operations.

DSMSERV UNLOADDB The operation that this utility performed isno longer needed.

Deleted server options

When you start the server, you might receive warning messages about serveroptions that are not supported, but that do not appear in this list of deletedoptions. V5 releases tolerated the presence of some server options that were notsupported by the server. The V6.1 server flags such options by issuing warningmessages. You can ignore the error, or update the server options file and restart theserver.

Table 13. Deleted server optionsDeleted option Comments

BUFPOOLSIZE The server adjusts the value of buffer poolsize dynamically.

DBPAGESHADOW The option is no longer needed.

DBPAGESHADOWFILE The option is no longer needed.

LOGPOOLSIZE The server uses its own fixed-size recoverylog buffer pool.

LOGWARNFULLPERCENT The option is no longer needed.

MIRRORREADMIRRORWRITE

Mirroring of the active log is supported, butnot of the database. Provide availabilityprotection for the database by locating thedatabase on devices that have highavailability characteristics.

SELFTUNEBUFPOOLSIZE The server adjusts the buffer pool sizedynamically.

xxxvi IBM Tivoli Storage Manager for AIX: Administrators Reference

||||||

Changes to the SELECT commandThe SELECT command in previous versions of the server allowed syntax that didnot always co

tivoli storage manager for aix administrator's reference

Documents