1. Tivoli Storage Manager
®
for Linux
Version 6.1
Administrator’s Reference
SC23-9777-01

3. Tivoli Storage Manager
®
for Linux
Version 6.1
Administrator’s Reference
SC23-9777-01

4. Note
Before using this information and the product it supports, read the information in “Notices” on page 1247.
This edition applies to Version 6.1 of IBM Tivoli Storage Manager and to all subsequent releases and modifications
until 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 Contract
with IBM Corp.

5. Contents
Preface . . . . . . . . . . . . . . . xi Formatting output from commands . . . . . 4.
Who should read this publication . . . . . . . xi Saving command output to a specified location . 4.
Publications . . . . . . . . . . . . . . xi Administrative client options . . . . . . . 5.
Tivoli Storage Manager publications . . . . . xi Issuing commands from the Administration Center 7.
Related hardware publications . . . . . . . xiii Issuing commands from the server console . . . 7.
Support information . . . . . . . . . . . xiii Entering administrative commands . . . . . . 8.
Getting technical training . . . . . . . . xiv Reading syntax diagrams . . . . . . . . 8.
Searching knowledge bases . . . . . . . . xiv Entering long commands . . . . . . . . . 11
Contacting IBM Software Support . . . . . . xv Naming Tivoli Storage Manager objects . . . . 12
Conventions used in this publication . . . . . xvii Using wildcard characters to specify object
names . . . . . . . . . . . . . . . 13
New for IBM Tivoli Storage Manager Specifying descriptions in keyword parameters 14
Controlling command processing . . . . . . . 14
Version 6.1. . . . . . . . . . . . . xix Server command processing . . . . . . . . 14
| New for the server in Version 6.1.2 . . . . . . xix Cancelling commands . . . . . . . . . . 15
| Enabled functions . . . . . . . . . . . xix Performing tasks concurrently on multiple servers 16
| Licensing changes . . . . . . . . . . . xix Routing commands to a single server. . . . . 16
| PREVIEW parameter for DSMSERV INSERTDB xx Routing commands to multiple servers . . . . 16
| SAN discovery support for Linux on zSeries . . xx Routing commands to a server group. . . . . 17
| New server option SANDISCOVERYTIMEOUT xx Routing commands to server groups . . . . . 17
New for the server in Version 6.1.0 . . . . . . xx Routing commands to two servers and a server
| Disabled functions in 6.1.0 and 6.1.1 . . . . . xx group . . . . . . . . . . . . . . . 17
Changes to the Version 6.1 Administration Routing commands inside scripts . . . . . . 17
Center . . . . . . . . . . . . . . . xxi Privilege classes for commands . . . . . . . . 18
Data deduplication . . . . . . . . . . xxiii Commands requiring system privilege . . . . 18
Storage devices . . . . . . . . . . . xxiv Commands requiring policy privilege . . . . 21
Disaster recovery manager support for Commands requiring storage privilege . . . . 22
active-data pools . . . . . . . . . . . xxv Commands requiring operator privilege . . . . 23
EXPIRE INVENTORY command enhancements xxvi Commands any administrator can issue . . . . 24
No-query restore changes . . . . . . . . xxvii
Server database . . . . . . . . . . . xxvii
Support for NetApp SnapMirror to Tape
Chapter 2. Administrative commands 27
feature . . . . . . . . . . . . . . xxvii ACCEPT DATE (Accepts the current system date) 28
Reporting and monitoring feature . . . . . xxvii ACTIVATE POLICYSET (Activate a new policy set) 29
ODBC driver support . . . . . . . . . xxviii ASSIGN DEFMGMTCLASS (Assign a default
Backup sets and client node enhancements xxviii management class) . . . . . . . . . . . . 31
AUDIT commands . . . . . . . . . . . . 33
AUDIT LIBRARY (Audit volume inventories in
Command and option changes . . . xxix an automated library) . . . . . . . . . . 34
New server commands, utilities, and options . . xxix AUDIT LICENSES (Audit server storage usage) 36
Updated server commands, utilities, and options xxxi AUDIT VOLUME (Verify database information
Deleted server commands, utilities, and options xxxiv for a storage pool volume) . . . . . . . . 37
Changes to the SELECT command . . . . . xxxvii BACKUP commands . . . . . . . . . . . 43
BACKUP DB (Back up the database) . . . . . 44
Chapter 1. Administering the server BACKUP DEVCONFIG (Create backup copies of
from the command line . . . . . . . . 1 device configuration information) . . . . . . 47
Issuing commands from the administrative client . . 1 BACKUP NODE (Back up a NAS node) . . . . 49
Starting and stopping the administrative client . . 2 BACKUP STGPOOL (Back up primary storage
Monitoring server activities from the pool to copy storage pool) . . . . . . . . 54
administrative client . . . . . . . . . . . 2 BACKUP VOLHISTORY (Save sequential volume
Monitoring removable-media mounts from the history information) . . . . . . . . . . 58
administrative client . . . . . . . . . . . 2 BEGIN EVENTLOGGING (Begin logging events) . . 60
Processing commands one at a time from the CANCEL commands . . . . . . . . . . . 62
administrative client . . . . . . . . . . . 3 CANCEL EXPIRATION (Cancel an expiration
Processing a series of commands from the process) . . . . . . . . . . . . . . 63
administrative client . . . . . . . . . . . 3
© Copyright IBM Corp. 1993, 2009 iii

6. CANCEL EXPORT (Delete a suspended export DEFINE MGMTCLASS (Define a management
operation) . . . . . . . . . . . . . . 64 class) . . . . . . . . . . . . . . . 219
CANCEL PROCESS (Cancel an administrative DEFINE NODEGROUP (Define a node group) 222
process) . . . . . . . . . . . . . . 65 DEFINE NODEGROUPMEMBER (Define node
CANCEL REQUEST (Cancel one or more mount group member). . . . . . . . . . . . 223
requests) . . . . . . . . . . . . . . 67 DEFINE PATH (Define a path) . . . . . . 224
CANCEL RESTORE (Cancel a restartable restore DEFINE POLICYSET (Define a policy set) . . . 230
session). . . . . . . . . . . . . . . 68 DEFINE PROFASSOCIATION (Define a profile
CANCEL SESSION (Cancel one or more client association) . . . . . . . . . . . . . 232
sessions) . . . . . . . . . . . . . . 69 DEFINE PROFILE (Define a profile) . . . . . 238
CHECKIN LIBVOLUME (Check a storage volume DEFINE RECMEDMACHASSOCIATION
into a library). . . . . . . . . . . . . . 70 (Associate recovery media with a machine) . . 240
CHECKOUT LIBVOLUME (Check a storage volume DEFINE RECOVERYMEDIA (Define recovery
out of a library) . . . . . . . . . . . . . 77 media) . . . . . . . . . . . . . . 242
CLEAN DRIVE (Clean a drive) . . . . . . . . 83 DEFINE SCHEDULE (Define a client or an
COMMIT (Control committing of commands in a administrative command schedule) . . . . . 244
macro) . . . . . . . . . . . . . . . . 84 DEFINE SCRIPT (Define a Tivoli Storage
COPY commands . . . . . . . . . . . . 85 Manager script) . . . . . . . . . . . 265
COPY ACTIVEDATA (Copy active backup data DEFINE SERVER (Define a server for
from a primary storage pool to an active-data server-to-server communications). . . . . . 267
pool) . . . . . . . . . . . . . . . 86 DEFINE SERVERGROUP (Define a server
COPY CLOPTSET (Copy a client option set) . . 90 group). . . . . . . . . . . . . . . 272
COPY DOMAIN (Copy a policy domain) . . . 91 DEFINE SPACETRIGGER (Define the space
COPY MGMTCLASS (Copy a management class) 93 trigger) . . . . . . . . . . . . . . 273
COPY POLICYSET (Copy a policy set) . . . . 95 DEFINE STGPOOL (Define a storage pool) . . 276
COPY PROFILE (Copy a profile) . . . . . . 97 DEFINE SUBSCRIPTION (Define a profile
COPY SCHEDULE (Copy a client or an subscription) . . . . . . . . . . . . 317
administrative command schedule) . . . . . 99 DEFINE VIRTUALFSMAPPING (Define a
COPY SCRIPT (Copy a Tivoli Storage Manager virtual file space mapping) . . . . . . . . 319
script) . . . . . . . . . . . . . . . 103 DEFINE VOLUME (Define a volume in a
COPY SERVERGROUP (Copy a server group) 104 storage pool) . . . . . . . . . . . . 321
DEFINE commands . . . . . . . . . . . 105 DELETE commands . . . . . . . . . . . 326
DEFINE ASSOCIATION (Associate client nodes DELETE ASSOCIATION (Delete the node
with a schedule) . . . . . . . . . . . 106 association to a schedule) . . . . . . . . 328
DEFINE BACKUPSET (Define a backup set) . . 108 DELETE BACKUPSET (Delete a backup set) . . 330
DEFINE CLIENTACTION (Define a one-time DELETE CLIENTOPT (Delete an option in an
client action). . . . . . . . . . . . . 113 option set) . . . . . . . . . . . . . 335
DEFINE CLIENTOPT (Define an option to an DELETE CLOPTSET (Delete a client option set) 336
option set) . . . . . . . . . . . . . 118 DELETE COLLOCGROUP (Delete a collocation
DEFINE CLOPTSET (Define a client option set group). . . . . . . . . . . . . . . 337
name) . . . . . . . . . . . . . . . 121 DELETE COLLOCMEMBER (Delete collocation
DEFINE COLLOCGROUP (Define a collocation group member). . . . . . . . . . . . 338
group). . . . . . . . . . . . . . . 122 DELETE COPYGROUP (Delete a backup or
DEFINE COLLOCMEMBER (Define collocation archive copy group) . . . . . . . . . . 340
group member). . . . . . . . . . . . 124 DELETE DATAMOVER (Delete a data mover) 342
DEFINE COPYGROUP (Define a copy group) 126 DELETE DEVCLASS (Delete a device class) . . 343
DEFINE DATAMOVER (Define a data mover) 136 DELETE DOMAIN (Delete a policy domain) 344
DEFINE DEVCLASS (Define a device class) . . 139 DELETE DRIVE (Delete a drive from a library) 345
DEFINE DOMAIN (Define a new policy DELETE EVENT (Delete event records). . . . 346
domain) . . . . . . . . . . . . . . 198 DELETE EVENTSERVER (Delete the definition
DEFINE DRIVE (Define a drive to a library) . . 200 of the event server) . . . . . . . . . . 348
DEFINE EVENTSERVER (Define a server as the DELETE FILESPACE (Delete client node data
event server) . . . . . . . . . . . . 204 from the server) . . . . . . . . . . . 349
DEFINE GRPMEMBER (Add a server to a DELETE GRPMEMBER (Delete a server from a
server group) . . . . . . . . . . . . 205 server group) . . . . . . . . . . . . 353
DEFINE LIBRARY (Define a library). . . . . 206 DELETE LIBRARY (Delete a library). . . . . 354
DEFINE MACHINE (Define machine DELETE MACHINE (Delete machine
information for disaster recovery) . . . . . 215 information) . . . . . . . . . . . . . 355
DEFINE MACHNODEASSOCIATION DELETE MACHNODEASSOCIATION (Delete
(Associate a node with a machine) . . . . . 217 association between a machine and a node) . . 356
iv IBM Tivoli Storage Manager for Linux: Administrator’s Reference

7. DELETE MGMTCLASS (Delete a management GENERATE commands . . . . . . . . . . 458
class) . . . . . . . . . . . . . . . 357 GENERATE BACKUPSET (Generate a backup
DELETE NODEGROUP (Delete a node group) 358 set of a client’s data) . . . . . . . . . . 459
DELETE NODEGROUPMEMBER (Delete node GENERATE BACKUPSETTOC (Generate a table
group member). . . . . . . . . . . . 359 of contents for a backup set) . . . . . . . 467
DELETE PATH (Delete a path) . . . . . . 360 GRANT commands . . . . . . . . . . . 470
DELETE POLICYSET (Delete a policy set) . . . 362 GRANT AUTHORITY (Add administrator
DELETE PROFASSOCIATION (Delete a profile authority) . . . . . . . . . . . . . 471
association) . . . . . . . . . . . . . 363 GRANT PROXYNODE (Grant proxy authority
DELETE PROFILE (Delete a profile) . . . . . 366 to a client node) . . . . . . . . . . . 475
DELETE RECMEDMACHASSOCIATION HALT (Shut down the server) . . . . . . . . 476
(Delete recovery media and machine HELP (Get help on commands and error messages) 478
association) . . . . . . . . . . . . . 368 IDENTIFY DUPLICATES (Identify duplicate data
DELETE RECOVERYMEDIA (Delete recovery in a storage pool) . . . . . . . . . . . . 480
media) . . . . . . . . . . . . . . 369 IMPORT commands . . . . . . . . . . . 484
DELETE SCHEDULE (Delete a client or an IMPORT ADMIN (Import administrator
administrative command schedule) . . . . . 370 information) . . . . . . . . . . . . . 485
DELETE SCRIPT (Delete command lines from a IMPORT NODE (Import client node
script or delete the entire script) . . . . . . 373 information) . . . . . . . . . . . . . 488
DELETE SERVER (Delete a server definition) 374 IMPORT POLICY (Import policy information) 494
DELETE SERVERGROUP (Delete a server IMPORT SERVER (Import server information) 497
group). . . . . . . . . . . . . . . 375 INSERT MACHINE (Insert machine characteristics
DELETE SPACETRIGGER (Delete the storage information or recovery instructions) . . . . . 502
pool space triggers) . . . . . . . . . . 376 ISSUE MESSAGE (Issue a message from a server
DELETE STGPOOL (Delete a storage pool) . . 377 script) . . . . . . . . . . . . . . . . 504
DELETE SUBSCRIBER (Delete subscriptions LABEL LIBVOLUME (Label a library volume) . . 506
from a configuration manager database) . . . 378 LOCK commands . . . . . . . . . . . . 512
DELETE SUBSCRIPTION (Delete a profile LOCK ADMIN (Lock out an administrator) . . 513
subscription) . . . . . . . . . . . . 379 LOCK NODE (Lock out a client node) . . . . 514
DELETE VIRTUALFSMAPPING (Delete a LOCK PROFILE (Lock a profile) . . . . . . 515
virtual file space mapping) . . . . . . . . 380 MACRO (Invoke a macro) . . . . . . . . . 517
DELETE VOLHISTORY (Delete sequential MIGRATE STGPOOL (Migrate storage pool to next
volume history information) . . . . . . . 381 storage pool) . . . . . . . . . . . . . 519
DELETE VOLUME (Delete a storage pool MOVE commands . . . . . . . . . . . . 522
volume) . . . . . . . . . . . . . . 386 MOVE DATA (Move files on a storage pool
DISABLE commands . . . . . . . . . . . 389 volume) . . . . . . . . . . . . . . 523
DISABLE EVENTS (Disable events for event MOVE DRMEDIA (Move disaster recovery
logging) . . . . . . . . . . . . . . 390 media offsite and back onsite) . . . . . . . 527
DISABLE SESSIONS (Temporarily prevent client MOVE GRPMEMBER (Move a server group
node access to the server) . . . . . . . . 394 member) . . . . . . . . . . . . . . 541
DISMOUNT command . . . . . . . . . . 396 MOVE MEDIA (Move sequential access storage
DISMOUNT VOLUME (Dismount a volume by pool media) . . . . . . . . . . . . . 542
volume name) . . . . . . . . . . . . 397 MOVE NODEDATA (Move data by node in a
DISPLAY OBJNAME (Display a full object name) 398 sequential access storage pool) . . . . . . 550
ENABLE commands . . . . . . . . . . . 399 NOTIFY SUBSCRIBERS (Notify managed servers
ENABLE EVENTS (Enable server or client to update profiles). . . . . . . . . . . . 559
events for logging) . . . . . . . . . . 400 PARALLEL (Run multiple commands in a script in
ENABLE SESSIONS (Resume user activity on parallel) . . . . . . . . . . . . . . . 560
the server) . . . . . . . . . . . . . 403 PING SERVER (Test the connection between
END EVENTLOGGING (Stop logging events) . . 405 servers) . . . . . . . . . . . . . . . 562
EXPIRE INVENTORY (Manually start inventory PREPARE (Create a recovery plan file) . . . . . 563
expiration processing) . . . . . . . . . . 407 QUERY commands . . . . . . . . . . . 568
EXPORT commands . . . . . . . . . . . 411 QUERY ACTLOG (Query the activity log) . . . 570
EXPORT ADMIN (Export administrator QUERY ADMIN (Display administrator
information) . . . . . . . . . . . . . 412 information) . . . . . . . . . . . . . 575
EXPORT NODE (Export client node QUERY ASSOCIATION (Query client node
information) . . . . . . . . . . . . . 418 associations with a schedule) . . . . . . . 579
EXPORT POLICY (Export policy information) 436 QUERY AUDITOCCUPANCY (Query client
EXPORT SERVER (Export server information) 442 node storage utilization). . . . . . . . . 581
EXTEND DBSPACE (Increase space for the QUERY BACKUPSET (Query a backup set) . . 584
database) . . . . . . . . . . . . . . . 457
Contents v

8. QUERY BACKUPSETCONTENTS (Query QUERY PROFILE (Query a profile) . . . . . 721
contents of a backup set) . . . . . . . . 589 QUERY PROXYNODE (Query proxy authority
QUERY CLOPTSET (Query a client option set) 592 for a client node) . . . . . . . . . . . 724
QUERY COLLOCGROUP (Query a collocation QUERY RECOVERYMEDIA (Query recovery
group). . . . . . . . . . . . . . . 594 media) . . . . . . . . . . . . . . 725
QUERY CONTENT (Query the contents of a QUERY REQUEST (Query one or more pending
storage pool volume) . . . . . . . . . . 597 mount requests) . . . . . . . . . . . 728
QUERY COPYGROUP (Query copy groups) . . 604 QUERY RESTORE (Query restartable restore
QUERY DATAMOVER (Display data mover sessions) . . . . . . . . . . . . . . 729
definitions) . . . . . . . . . . . . . 609 QUERY RPFCONTENT (Query recovery plan
QUERY DB (Display database information) . . 612 file contents stored on a target server) . . . . 732
QUERY DBSPACE (Display database storage QUERY RPFILE (Query recovery plan file
space) . . . . . . . . . . . . . . . 615 information stored on a target server) . . . . 734
QUERY DEVCLASS (Display information on QUERY SAN (Query the devices on the SAN) 737
one or more device classes). . . . . . . . 616 QUERY SCHEDULE (Query schedules). . . . 740
QUERY DIRSPACE (Query storage utilization of QUERY SCRIPT (Query Tivoli Storage Manager
FILE directories) . . . . . . . . . . . 620 scripts) . . . . . . . . . . . . . . 748
QUERY DOMAIN (Query a policy domain) . . 621 QUERY SERVER (Query a server) . . . . . 751
QUERY DRIVE (Query information about a QUERY SERVERGROUP (Query a server group) 755
drive) . . . . . . . . . . . . . . . 624 QUERY SESSION (Query client sessions) . . . 757
QUERY DRMEDIA (Query disaster recovery QUERY SHREDSTATUS (Query shredding
media) . . . . . . . . . . . . . . 628 status ) . . . . . . . . . . . . . . 761
QUERY DRMSTATUS (Query disaster recovery QUERY SPACETRIGGER (Query the space
manager system parameters) . . . . . . . 637 triggers) . . . . . . . . . . . . . . 763
QUERY ENABLED (Query enabled events) . . 640 QUERY STATUS (Query system parameters) 765
QUERY EVENT (Query scheduled and QUERY STGPOOL (Query storage pools) . . . 771
completed events) . . . . . . . . . . . 642 QUERY SUBSCRIBER (Display subscriber
QUERY EVENTRULES (Query rules for server information) . . . . . . . . . . . . . 782
or client events) . . . . . . . . . . . 654 QUERY SUBSCRIPTION (Display subscription
QUERY EVENTSERVER (Query the event information) . . . . . . . . . . . . . 784
server). . . . . . . . . . . . . . . 656 QUERY SYSTEM (Query the system
QUERY EXPORT (Query for active or configuration and capacity). . . . . . . . 786
suspended export operations) . . . . . . . 657 QUERY TAPEALERTMSG (Display status of
QUERY FILESPACE (Query one or more file SET TAPEALERTMSG command) . . . . . 788
spaces) . . . . . . . . . . . . . . 664 QUERY TOC (Display table of contents for a
QUERY LIBRARY (Query a library) . . . . . 669 backup image) . . . . . . . . . . . . 789
QUERY LIBVOLUME (Query a library volume) 672 QUERY VIRTUALFSMAPPING (Query a virtual
QUERY LICENSE (Display license information) 675 file space mapping) . . . . . . . . . . 792
QUERY LOG (Display information on the QUERY VOLHISTORY (Display sequential
recovery log) . . . . . . . . . . . . 676 volume history information) . . . . . . . 794
QUERY MACHINE (Query machine QUERY VOLUME (Query storage pool
information) . . . . . . . . . . . . . 678 volumes) . . . . . . . . . . . . . . 801
QUERY MEDIA (Query sequential access QUIT (End the interactive mode of the
storage pool media) . . . . . . . . . . 681 administrative client) . . . . . . . . . . . 808
QUERY MGMTCLASS (Query a management RECLAIM STGPOOL (Reclaim volumes in a
class) . . . . . . . . . . . . . . . 687 sequential-access storage pool) . . . . . . . 809
QUERY MOUNT (Display information on RECONCILE VOLUMES (Reconcile differences in
mounted sequential access volumes). . . . . 690 the virtual volume definitions) . . . . . . . 812
QUERY NASBACKUP (Query NAS backup REGISTER commands . . . . . . . . . . 815
images) . . . . . . . . . . . . . . 691 REGISTER ADMIN (Register an administrator) 816
QUERY NODE (Query nodes) . . . . . . . 695 REGISTER LICENSE (Register a new license) 818
QUERY NODEDATA (Query client data in REGISTER NODE (Register a node) . . . . . 820
volumes) . . . . . . . . . . . . . . 702 REMOVE commands . . . . . . . . . . . 830
QUERY NODEGROUP (Query a node group) 705 REMOVE ADMIN (Delete an administrator) . . 831
QUERY OCCUPANCY (Query client file spaces REMOVE NODE (Delete a node or an
in storage pools) . . . . . . . . . . . 707 associated machine node) . . . . . . . . 832
QUERY OPTION (Query server options) . . . 711 RENAME commands . . . . . . . . . . . 834
QUERY PATH (Display a path definition) . . . 712 RENAME ADMIN (Rename an administrator) 835
QUERY POLICYSET (Query a policy set) . . . 716 RENAME FILESPACE (Rename a client file
QUERY PROCESS (Query one or more server space on the server) . . . . . . . . . . 836
processes) . . . . . . . . . . . . . 719 RENAME NODE (Rename a node) . . . . . 839
vi IBM Tivoli Storage Manager for Linux: Administrator’s Reference

9. RENAME SCRIPT (Rename a Tivoli Storage SET DRMDBBACKUPEXPIREDAYS (Specify DB
Manager script) . . . . . . . . . . . 840 backup series expiration) . . . . . . . . 902
RENAME SERVERGROUP (Rename a server SET DRMFILEPROCESS (Specify file
group). . . . . . . . . . . . . . . 841 processing) . . . . . . . . . . . . . 904
RENAME STGPOOL (Change the name of a SET DRMINSTRPREFIX (Specify the prefix for
storage pool) . . . . . . . . . . . . 842 recovery instructions file names) . . . . . . 905
REPLY (Allow a request to continue processing) 843 SET DRMNOTMOUNTABLENAME (Specify the
RESET PASSEXP (Reset password expiration) . . 844 not mountable location name) . . . . . . . 907
RESTART EXPORT (Restart a suspended export SET DRMPLANPREFIX (Specify a prefix for
operation) . . . . . . . . . . . . . . 846 recovery plan file names) . . . . . . . . 908
RESTORE commands. . . . . . . . . . . 848 SET DRMPLANVPOSTFIX (Specify replacement
RESTORE NODE (Restore a NAS node) . . . 849 volume names) . . . . . . . . . . . . 910
RESTORE STGPOOL (Restore storage pool data SET DRMPRIMSTGPOOL (Specify the primary
from a copy pool or an active-data pool) . . . 854 storage pools to be managed by DRM) . . . . 911
RESTORE VOLUME (Restore primary volume SET DRMRPFEXPIREDAYS (Set criteria for
data from a copy pool or an active-data pool) . 858 recovery plan file expiration) . . . . . . . 912
REVOKE commands . . . . . . . . . . . 863 SET DRMVAULTNAME (Specify the vault
REVOKE AUTHORITY (Remove administrator name) . . . . . . . . . . . . . . . 914
authority) . . . . . . . . . . . . . 864 SET EVENTRETENTION (Set the retention
REVOKE PROXYNODE (Revoke proxy period for event records) . . . . . . . . 915
authority for a client node) . . . . . . . . 868 SET INVALIDPWLIMIT (Set the number of
ROLLBACK (Rollback uncommitted changes in a invalid logon attempts) . . . . . . . . . 916
macro). . . . . . . . . . . . . . . . 869 SET LICENSEAUDITPERIOD (Set license audit
RUN (Run a Tivoli Storage Manager script) . . . 870 period) . . . . . . . . . . . . . . 917
SELECT (Perform an SQL query of the IBM Tivoli SET MAXCMDRETRIES (Set the maximum
Storage Manager database) . . . . . . . . . 873 number of command retries) . . . . . . . 918
SERIAL (Run multiple commands in a script in SET MAXSCHEDSESSIONS (Set maximum
serial) . . . . . . . . . . . . . . . . 880 scheduled sessions) . . . . . . . . . . 919
SET commands . . . . . . . . . . . . . 881 SET MINPWLENGTH (Set minimum password
SET ACCOUNTING (Set accounting records on length) . . . . . . . . . . . . . . 920
or off) . . . . . . . . . . . . . . . 883 SET PASSEXP (Set password expiration date) 921
SET ACTLOGRETENTION (Set the retention SET QUERYSCHEDPERIOD (Set query period
period or the size of the activity log) . . . . 884 for polling client nodes) . . . . . . . . . 923
SET ARCHIVERETENTIONPROTECTION SET RANDOMIZE (Set randomization of
(Activate data retention protection) . . . . . 886 scheduled start times) . . . . . . . . . 924
SET AUTHENTICATION (Set password SET REGISTRATION (Set open or closed
authentication) . . . . . . . . . . . . 888 registration) . . . . . . . . . . . . . 926
SET CLIENTACTDURATION (Set the duration SET RETRYPERIOD (Set time between retry
period for the client action). . . . . . . . 889 attempts) . . . . . . . . . . . . . . 928
SET CONFIGMANAGER (Specify a SET SCHEDMODES (Select a central scheduling
configuration manager) . . . . . . . . . 890 mode) . . . . . . . . . . . . . . . 929
SET CONFIGREFRESH (Set managed server SET SERVERHLADDRESS (Set the high-level
configuration refresh). . . . . . . . . . 891 address of a server) . . . . . . . . . . 931
SET CONTEXTMESSAGING (Set message SET SERVERLLADDRESS (Set the low-level
context reporting on or off) . . . . . . . . 892 address of a server) . . . . . . . . . . 932
SET CROSSDEFINE (Specifies whether to SET SERVERNAME (Specify the server name) 933
cross-define servers) . . . . . . . . . . 893 SET SERVERPASSWORD (Set password for
SET DBRECOVERY (Set the device class for server). . . . . . . . . . . . . . . 934
automatic backups) . . . . . . . . . . 894 SET SUBFILE (Set subfile backup for client
SET DBREPORTMODE (Set the level of nodes) . . . . . . . . . . . . . . . 935
database reporting) . . . . . . . . . . 895 SET SUMMARYRETENTION (Set number of
SET DRMACTIVEDATASTGPOOL (Specify the days to keep data in activity summary table) . . 936
active-data pools to be managed by DRM) . . 896 SET TAPEALERTMSG (Set tape alert messages
SET DRMCHECKLABEL (Specify label on or off) . . . . . . . . . . . . . . 937
checking) . . . . . . . . . . . . . . 898 SET TOCLOADRETENTION (Set load retention
SET DRMCMDFILENAME (Specify the name of period for table of contents) . . . . . . . 938
a file to contain commands) . . . . . . . 899 SETOPT (Set a server option for dynamic update) 939
SET DRMCOPYSTGPOOL (Specify the copy SHRED DATA (Shred data). . . . . . . . . 941
storage pools to be managed by DRM) . . . . 900 SUSPEND EXPORT (Suspend a currently running
SET DRMCOURIERNAME (Specify the courier export operation) . . . . . . . . . . . . 943
name) . . . . . . . . . . . . . . . 901 UNLOCK commands . . . . . . . . . . . 944
Contents vii

10. UNLOCK ADMIN (Unlock an administrator) 945 Types of server options . . . . . . . . . . 1138
UNLOCK NODE (Unlock a client node) . . . 946 Communication options . . . . . . . . 1138
UNLOCK PROFILE (Unlock a profile) . . . . 947 Server storage options . . . . . . . . . 1139
UPDATE commands . . . . . . . . . . . 948 Client-server options . . . . . . . . . 1139
UPDATE ADMIN (Update an administrator) 949 Date, number, time, and language options . . 1140
UPDATE BACKUPSET (Update a retention Database options . . . . . . . . . . . 1140
value assigned to a backup set) . . . . . . 951 Data transfer options . . . . . . . . . 1140
UPDATE CLIENTOPT (Update a client option Message options . . . . . . . . . . . 1141
sequence number) . . . . . . . . . . . 956 Event logging options . . . . . . . . . 1141
UPDATE CLOPTSET (Update a client option set Security options and licensing options. . . . 1141
description) . . . . . . . . . . . . . 957 Miscellaneous options . . . . . . . . . 1142
UPDATE COLLOCGROUP (Update a 3494SHARED . . . . . . . . . . . . . 1143
collocation group) . . . . . . . . . . . 958 ACSACCESSID . . . . . . . . . . . . 1144
UPDATE COPYGROUP (Update a copy group) 959 ACSLOCKDRIVE. . . . . . . . . . . . 1145
UPDATE DATAMOVER (Update a data mover) 967 ACSQUICKINIT . . . . . . . . . . . . 1146
UPDATE DEVCLASS (Update the attributes of a ACSTIMEOUTX . . . . . . . . . . . . 1147
device class) . . . . . . . . . . . . . 969 ACTIVELOGDIR . . . . . . . . . . . . 1148
UPDATE DOMAIN (Update a policy domain) 1022 ACTIVELOGSIZE . . . . . . . . . . . 1149
UPDATE DRIVE (Update a drive) . . . . . 1024 ADMINONCLIENTPORT . . . . . . . . . 1150
UPDATE LIBRARY (Update a library) . . . . 1028 ALIASHALT . . . . . . . . . . . . . 1151
UPDATE LIBVOLUME (Change the status of a ARCHFAILOVERLOGDIR. . . . . . . . . 1152
storage volume) . . . . . . . . . . . 1033 | ARCHIVELOGDIR . . . . . . . . . . . 1153
UPDATE MACHINE (Update machine ASSISTVCRRECOVERY . . . . . . . . . 1154
information) . . . . . . . . . . . . 1035 AUDITSTORAGE . . . . . . . . . . . 1155
UPDATE MGMTCLASS (Update a COMMMETHOD. . . . . . . . . . . . 1156
management class) . . . . . . . . . . 1037 COMMTIMEOUT . . . . . . . . . . . 1157
UPDATE NODE (Update node attributes) . . 1040 DBMEMPERCENT . . . . . . . . . . . 1158
UPDATE NODEGROUP (Update a node DEDUPREQUIRESBACKUP . . . . . . . . 1159
group) . . . . . . . . . . . . . . 1048 DEVCONFIG . . . . . . . . . . . . . 1160
UPDATE PATH (Change a path) . . . . . 1049 DISABLESCHEDS . . . . . . . . . . . 1161
UPDATE POLICYSET (Update a policy set DISKSTGPOOLMEMSIZE . . . . . . . . . 1161
description) . . . . . . . . . . . . 1054 DISPLAYLFINFO . . . . . . . . . . . . 1162
UPDATE PROFILE (Update a profile DNSLOOKUP . . . . . . . . . . . . . 1163
description) . . . . . . . . . . . . 1056 DRIVEACQUIRERETRY . . . . . . . . . 1164
UPDATE RECOVERYMEDIA (Update recovery EVENTSERVER . . . . . . . . . . . . 1165
media) . . . . . . . . . . . . . . 1057 EXPINTERVAL . . . . . . . . . . . . 1166
UPDATE SCHEDULE (Update a schedule) 1059 EXPQUIET . . . . . . . . . . . . . . 1167
UPDATE SCRIPT (Update a Tivoli Storage FILEEXIT . . . . . . . . . . . . . . 1168
Manager script) . . . . . . . . . . . 1079 FILETEXTEXIT . . . . . . . . . . . . 1169
UPDATE SERVER (Update a server defined for IDLETIMEOUT . . . . . . . . . . . . 1170
server-to-server communications) . . . . . 1081 LANGUAGE . . . . . . . . . . . . . 1171
UPDATE SERVERGROUP (Update a server MAXSESSIONS . . . . . . . . . . . . 1173
group description) . . . . . . . . . . 1085 MESSAGEFORMAT . . . . . . . . . . . 1174
UPDATE SPACETRIGGER (Update the space MIRRORLOGDIR . . . . . . . . . . . 1175
triggers) . . . . . . . . . . . . . . 1086 MOVEBATCHSIZE . . . . . . . . . . . 1176
UPDATE STGPOOL (Update a storage pool) 1088 MOVESIZETHRESH. . . . . . . . . . . 1177
UPDATE VIRTUALFSMAPPING (Update a MSGINTERVAL . . . . . . . . . . . . 1178
virtual file space mapping) . . . . . . . 1122 NDMPCONTROLPORT . . . . . . . . . 1179
UPDATE VOLHISTORY (Update sequential NDMPPORTRANGE . . . . . . . . . . 1180
volume history information) . . . . . . . 1124 NDMPPREFDATAINTERFACE . . . . . . . 1181
UPDATE VOLUME (Change a storage pool NOPREEMPT . . . . . . . . . . . . . 1182
volume) . . . . . . . . . . . . . . 1126 NORETRIEVEDATE . . . . . . . . . . . 1183
VALIDATE commands . . . . . . . . . . 1130 NUMOPENVOLSALLOWED . . . . . . . . 1184
VALIDATE LANFREE (Validate LAN-Free QUERYAUTH . . . . . . . . . . . . . 1186
paths) . . . . . . . . . . . . . . 1131 RECLAIMDELAY . . . . . . . . . . . 1187
VALIDATE POLICYSET (Verify a policy set) 1133 RECLAIMPERIOD . . . . . . . . . . . 1188
VARY (Bring a random access volume online or REPORTRETRIEVE . . . . . . . . . . . 1189
offline) . . . . . . . . . . . . . . . 1135 REQSYSAUTHOUTFILE . . . . . . . . . 1190
RESOURCETIMEOUT . . . . . . . . . . 1191
Chapter 3. Server options . . . . . 1137 RESTOREINTERVAL . . . . . . . . . . 1192
Modifying server options . . . . . . . . . 1137 RETENTIONEXTENSION . . . . . . . . . 1193
viii IBM Tivoli Storage Manager for Linux: Administrator’s Reference

11. SANDISCOVERY. . . . . . . . . . . . 1194 The server startup script: rc.dsmserv . . . . . 1225
| SANDISCOVERYTIMEOUT . . . . . . . . 1195 DSMSERV DISPLAY DBSPACE (Display
SANREFRESHTIME . . . . . . . . . . . 1196 information about database storage space) . . . 1226
SEARCHMPQUEUE. . . . . . . . . . . 1197 DSMSERV DISPLAY LOG (Display recovery log
SHMPORT . . . . . . . . . . . . . . 1198 information) . . . . . . . . . . . . . 1227
SHREDDING . . . . . . . . . . . . . 1199 DSMSERV FORMAT (Format the database and
SNMPHEARTBEATINTERVAL . . . . . . . 1200 log) . . . . . . . . . . . . . . . . 1229
SNMPMESSAGECATEGORY . . . . . . . . 1201 DSMSERV INSERTDB (Move a server database
SNMPSUBAGENT . . . . . . . . . . . 1202 into an empty database) . . . . . . . . . 1231
SNMPSUBAGENTHOST . . . . . . . . . 1203 DSMSERV LOADFORMAT (Format a database) 1233
SNMPSUBAGENTPORT . . . . . . . . . 1204 | DSMSERV REMOVEDB (Remove a database) 1235
TCPADMINPORT . . . . . . . . . . . 1205 DSMSERV RESTORE DB (Restore the database) 1236
TCPBUFSIZE . . . . . . . . . . . . . 1206 DSMSERV RESTORE DB (Restore a database to
TCPNODELAY . . . . . . . . . . . . 1207 its most current state) . . . . . . . . . 1237
TCPPORT . . . . . . . . . . . . . . 1208 DSMSERV RESTORE DB (Restore a database to
TCPWINDOWSIZE . . . . . . . . . . . 1209 a point-in-time) . . . . . . . . . . . 1239
TECBEGINEVENTLOGGING . . . . . . . 1210
TECHOST . . . . . . . . . . . . . . 1211 Appendix A. Return codes for use in
TECPORT . . . . . . . . . . . . . . 1212 IBM Tivoli Storage Manager scripts . 1243
TECUTF8EVENT . . . . . . . . . . . . 1213
THROUGHPUTDATATHRESHOLD . . . . . 1214
THROUGHPUTTIMETHRESHOLD . . . . . 1215 Appendix B. Accessibility features
TXNGROUPMAX . . . . . . . . . . . 1216 for Tivoli Storage Manager . . . . . 1245
UNIQUETDPTECEVENTS . . . . . . . . 1217
UNIQUETECEVENTS . . . . . . . . . . 1218 Notices . . . . . . . . . . . . . 1247
USEREXIT . . . . . . . . . . . . . . 1219 Trademarks . . . . . . . . . . . . . 1249
VERBCHECK . . . . . . . . . . . . . 1220
VOLUMEHISTORY . . . . . . . . . . . 1221 Glossary . . . . . . . . . . . . . 1251
Chapter 4. Server utilities. . . . . . 1223 Index . . . . . . . . . . . . . . 1273
DSMSERV (Start the server) . . . . . . . . 1224
Contents ix

12. x IBM Tivoli Storage Manager for Linux: Administrator’s Reference

13. Preface
IBM® Tivoli® Storage Manager is a client/server program that provides storage
management solutions to customers in a multi-vendor computer environment. IBM
Tivoli Storage Manager provides an automated, centrally scheduled,
policy-managed backup, archive, and space-management facility for file servers
and workstations.
Who should read this publication
This reference is intended for anyone who is registered as an administrator. A
single administrator can manage Tivoli Storage Manager, or several people can
share administrative responsibilities.
You should be familiar with the operating system on which the server resides and
the communication protocols required for the client/server environment. You also
need to understand the storage management practices of your organization, such
as how you are currently backing up workstation files and how you are using
storage devices.
Publications
Tivoli Storage Manager publications and other related publications are available
online.
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 Manager
Information 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 Center
Web site. The Web site provides information for ordering publications from
countries other than the United States. In the United States, you can order
publications by calling 800-879-2755.
Tivoli Storage Manager publications
Publications are available for the server, storage agent, client, and Data Protection.
Table 1. Tivoli Storage Manager server publications
Publication 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 Administrator’s Guide SC23-9769
IBM Tivoli Storage Manager for AIX Administrator’s Reference SC23-9775
IBM Tivoli Storage Manager for HP-UX Installation Guide GC23-9782
© Copyright IBM Corp. 1993, 2009 xi

14. Table 1. Tivoli Storage Manager server publications (continued)
Publication title Order number
IBM Tivoli Storage Manager for HP-UX Administrator’s Guide SC23-9770
IBM Tivoli Storage Manager for HP-UX Administrator’s Reference SC23-9776
IBM Tivoli Storage Manager for Linux Installation Guide GC23-9783
IBM Tivoli Storage Manager for Linux Administrator’s Guide SC23-9771
IBM Tivoli Storage Manager for Linux Administrator’s Reference SC23-9777
IBM Tivoli Storage Manager for Sun Solaris Installation Guide GC23-9784
IBM Tivoli Storage Manager for Sun Solaris Administrator’s Guide SC23-9772
IBM Tivoli Storage Manager for Sun Solaris Administrator’s Reference SC23-9778
IBM Tivoli Storage Manager for Windows Installation Guide GC23-9785
IBM Tivoli Storage Manager for Windows Administrator’s Guide SC23-9773
IBM Tivoli Storage Manager for Windows Administrator’s Reference SC23-9779
IBM Tivoli Storage Manager Server Upgrade Guide SC23-9554
IBM Tivoli Storage Manager for System Backup and Recovery Installation SC32-6543
and User’s Guide
Table 2. Tivoli Storage Manager storage agent publications
Publication title Order number
IBM Tivoli Storage Manager for SAN for AIX Storage Agent User’s SC23-9797
Guide
IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User’s SC23-9798
Guide
IBM Tivoli Storage Manager for SAN for Linux Storage Agent User’s SC23-9799
Guide
IBM Tivoli Storage Manager for SAN for Sun Solaris Storage Agent SC23-9800
User’s Guide
IBM Tivoli Storage Manager for SAN for Windows Storage Agent User’s SC23-9553
Guide
Table 3. Tivoli Storage Manager client publications
Publication title Order number
IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive SC23-9791
Clients Installation and User’s Guide
IBM Tivoli Storage Manager for Windows: Backup-Archive Clients SC23-9792
Installation and User’s Guide
IBM Tivoli Storage Manager for Space Management for UNIX and Linux: SC23-9794
User’s Guide
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 Edition GI11-8912
Backup-Archive Client
Program Directory for IBM Tivoli Storage Manager z/OS Edition GI11-8911
Application Program Interface
xii IBM Tivoli Storage Manager for Linux: Administrator’s Reference

15. Table 4. Tivoli Storage Manager Data Protection publications
Publication title Order number
IBM Tivoli Storage Manager for Advanced Copy Services: Data Protection SC33-8331
for Snapshot Devices Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft SC32-9059
SQL Server Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for SC32-9064
UNIX and Linux Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for SC32-9065
Windows Installation and User’s Guide
IBM Tivoli Storage Manager for Enterprise Resource Planning: Data SC33-6341
Protection for SAP Installation and User’s Guide for DB2
IBM Tivoli Storage Manager for Enterprise Resource Planning: Data SC33-6340
Protection for SAP Installation and User’s Guide for Oracle
IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino SC32-9056
for UNIX, Linux, and OS/400® Installation and User’s Guide
IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino SC32-9057
for Windows Installation and User’s Guide
IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft SC23-9796
Exchange Server Installation and User’s Guide
Program Directory for IBM Tivoli Storage Manager for Mail (Data GI11-8909
Protection for Lotus Domino)
Related hardware publications
The following table lists related IBM hardware products publications.
For additional information on hardware, see the resource library for tape products
at 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 User’s Guide GA32-0298
IBM Tape Device Drivers Installation and User’s Guide GC27-2130
IBM TotalStorage Enterprise Tape System 3590 Operator Guide GA32-0330
IBM TotalStorage Enterprise Tape System 3592 Operator Guide GA32-0465
Support information
You can find support information for IBM products from a variety of sources.
Preface xiii

16. Getting technical training
Information about Tivoli technical training courses is available online.
Go to http://www.ibm.com/software/tivoli/education/.
Searching knowledge bases
If you have a problem with Tivoli Storage Manager, there are several knowledge
bases that you can search.
You can begin with the Tivoli Storage Manager Information Center at
http://publib.boulder.ibm.com/infocenter/tsminfo/v6. From this Web site, you
can search all Tivoli Storage Manager publications.
Searching the Internet
If you cannot find an answer to your question in the Tivoli Storage Manager
information center, search the Internet for the latest, most complete information
that might help you resolve your problem.
To search multiple Internet resources, go to the support Web site for Tivoli Storage
Manager at http://www.ibm.com/software/sysmgmt/products/support/
IBMTivoliStorageManager.html. From there, you can search a variety of resources
including:
v IBM technotes
v IBM downloads
v IBM Redbooks®
If you still cannot find the solution to the problem, you can search forums and
newsgroups on the Internet for the latest information that might help you resolve
your problem. To share your experiences and learn from others in the user
community, go to the Tivoli Storage Manager wiki at http://www.ibm.com/
developerworks/wikis/display/tivolistoragemanager/Home.
Using IBM Support Assistant
At no additional cost, you can install on any workstation the IBM Support
Assistant, a stand-alone application. You can then enhance the application by
installing product-specific plug-in modules for the IBM products that you use.
The IBM Support Assistant helps you gather support information when you need
to open a problem management record (PMR), which you can then use to track the
problem. The product-specific plug-in modules provide you with the following
resources:
v Support links
v Education links
v Ability to submit problem management reports
For more information, see the IBM Support Assistant Web site at
http://www.ibm.com/software/support/isa/.
xiv IBM Tivoli Storage Manager for Linux: Administrator’s Reference

17. Finding product fixes
A product fix to resolve your problem might be available from the IBM Software
Support 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 fixes
You can get notifications about fixes and other news about IBM products.
To receive weekly e-mail notifications about fixes and other news about IBM
products, 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 your
user 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 the
appropriate 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 Support
You can contact IBM Software Support if you have an active IBM software
maintenance 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 for
information on contacting IBM Software Support.
Setting up a software maintenance contract
Set up a software maintenance contract. The type of contract that you need
depends 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), enroll
in 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 the
instructions.
– By Phone: For the phone number to call in your country, go to the IBM
Software Support Handbook Web page at http://www14.software.ibm.com/
webapp/set2/sas/f/handbook/home.html and click Contacts.
Preface xv

18. v For server software products, you can purchase a software maintenance
agreement by working directly with an IBM sales representative or an IBM
Business Partner. For more information about support for server software
products, go to the IBM Technical support advantage Web page at
http://www.ibm.com/servers/.
If you are not sure what type of software maintenance contract you need, call
1-800-IBMSERV (1-800-426-7378) in the United States. For a list of telephone
numbers of people who provide support for your location, go to the Software
Support Handbook page at http://www14.software.ibm.com/webapp/set2/sas/f/
handbook/home.html.
Determine the business impact
When 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 problem
you are reporting.
Severity 1 Critical business impact: You are unable to use the program,
resulting in a critical impact on operations. This condition
requires an immediate solution.
Severity 2 Significant business impact: The program is usable but is
severely limited.
Severity 3 Some business impact: The program is usable with less
significant features (not critical to operations) unavailable.
Severity 4 Minimal business impact: The problem causes little impact on
operations, or a reasonable circumvention to the problem has
been implemented.
Describe the problem and gather background information
When explaining a problem to IBM, it is helpful to be as specific as possible.
Include all relevant background information so that IBM Software Support
specialists 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 problem
symptoms? 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, operating
system, networking software, and so on.
v Are you currently using a workaround for this problem? If so, be prepared to
explain it when you report the problem.
xvi IBM Tivoli Storage Manager for Linux: Administrator’s Reference

19. Submit the problem to IBM Software Support
You can submit the problem to IBM Software Support online or by phone.
Online
Go to the IBM Software Support Web site at http://www.ibm.com/
software/support/probsub.html. Enter your information into the
appropriate problem submission tool.
By phone
For the phone number to call in your country, go to the contacts page of
the 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 inaccurate
documentation, IBM Software Support creates an Authorized Program Analysis
Report (APAR). The APAR describes the problem in detail. If a workaround is
possible, IBM Software Support provides one for you to implement until the APAR
is resolved and a fix is delivered. IBM publishes resolved APARs on the Tivoli
Storage Manager product support Web site at http://www.ibm.com/software/
sysmgmt/products/support/IBMTivoliStorageManager.html, so that users who
experience the same problem can benefit from the same resolutions.
Conventions used in this publication
v Command to be entered on the Linux 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 characters
corresponds to the number of bytes available to store an item. For languages in
which it takes a single byte to represent a displayable character, the character to
byte ratio is 1 to 1. However, for DBCS and other multi-byte languages, the
reference to characters refers only to the number of bytes available for the item and
may represent fewer actual characters.
Preface xvii

20. xviii IBM Tivoli Storage Manager for Linux: Administrator’s Reference

21. New for IBM Tivoli Storage Manager Version 6.1
Many features in the Tivoli Storage Manager Version 6.1 server are new for
previous Tivoli Storage Manager users.
| New for the server in Version 6.1.2
| Server fix pack 6.1.2 contains several new features, in addition to fixes for
| problems.
| Enabled functions
| Functions that were disabled in Tivoli Storage Manager V6.1.0 and V6.1.1 are now
| enabled in Version 6.1.2.
| Until Tivoli Storage Manager V6.1.2, a database that contained backup sets or
| tables of contents (TOCs) could not be upgraded to V6. These restrictions no
| longer 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 or
| YES
| v BACKUP NODE if the TOC parameter specifies PREFERRED or YES
| v DEFINE BACKUPSET
| v GENERATE BACKUPSET
| v GENERATE BACKUPSETTOC
| Licensing changes
| Following the release of Tivoli Storage Manager Version 6.1.2, Tivoli Storage
| Manager Version 6.1.0 will no longer be available for download or purchase. Due
| to this unique circumstance, certain 6.1.2 packages will be available with a license
| module. See the following information for details on how this situation affects your
| environment.
| Existing Version 6.1.0 and 6.1.1 users
| If you have installed version 6.1.0 and are using a version 6.1.0 license, you
| can download the 6.1.2 package from the Service FTP site. You can install
| the 6.1.2 package using the instructions in Installing a Tivoli Storage
| Manager fix pack.
| Version 5 users
| If you have not yet installed a version of the V6.1 server, when you
| upgrade, you must upgrade directly to version 6.1.2. Version 6.1.2 is
| available with a license module from Passport Advantage or from your
| Tivoli Storage Manager sales representative. You can upgrade from V5 to
| V6.1.2 using the instructions in Upgrading the server.
| New users
| Version 6.1.2 is available from Passport Advantage or from your Tivoli
| Storage Manager sales representative. You can install version 6.1.2 using
| the instructions in Installing Tivoli Storage Manager.
|
© Copyright IBM Corp. 1993, 2009 xix

22. Functions enabled in the V6.1.2 server
| PREVIEW parameter for DSMSERV INSERTDB
| A PREVIEW parameter is available for the DSMSERV INSERTDB utility in Tivoli
| Storage Manager fix pack level 6.1.2. The DSMSERV INSERTDB utility is used only
| as 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 steps
| of 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 source
| database is readable. You can also identify any data constraint violations before
| you run the actual upgrade process for your server.
| SAN discovery support for Linux on zSeries
| Support for SAN discovery functions is now available for the Linux on zSeries
| operating system beginning in Tivoli Storage Manager fix pack level 6.1.2.
| New server option SANDISCOVERYTIMEOUT
| A new server option is available for SAN discovery functions beginning in Tivoli
| Storage Manager fix pack level 6.1.2.
| The SANDISCOVERYTIMEOUT option specifies the amount of time allowed for
| host bus adapters to respond when they are queried by the SAN discovery process.
| Related reference
| “SANDISCOVERYTIMEOUT” on page 1195
| The SANDISCOVERYTIMEOUT option specifies the amount of time allowed for
| host bus adapters to respond when they are queried by the SAN discovery process.
| Once the time specified for the SANDISCOVERYTIMEOUT is reached, the process
| times out.
New for the server in Version 6.1.0
Tivoli Storage Manager server version 6.1.0 contains many new features and
changes.
| Disabled functions in 6.1.0 and 6.1.1
| Some 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 be
| upgraded to V6.1.0 or 6.1.1. The database upgrade utilities check for defined
| backup sets and existing TOCs. If either exists, the upgrade stops and a message is
| issued saying that the upgrade is not possible at the time. In addition, any
| operation 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 all
| backup 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 or
| YES
xx IBM Tivoli Storage Manager for Linux: Administrator’s Reference

23. Functions enabled in the V6.1.2 server
| v BACKUP NODE if the TOC parameter specifies PREFERRED or YES
| v DEFINE BACKUPSET
| v GENERATE BACKUPSET
| v GENERATE BACKUPSETTOC
Changes to the Version 6.1 Administration Center
Many features in the Tivoli Storage Manager Administration Center Version 6.1 are
new for previous users.
Updated Integrated Solutions Console
In V6.1, the Administration Center is hosted by the IBM Integrated Solutions
Console (ISC) Advanced Edition Version 7.1. After installation of the Integrated
Solutions Console installation completes, open a Web browser and enter the
following URL, which will display the logon screen for the Integrated Solutions
Console: https://local_host:9043/ibm/console. This screen indicates a successful
installation 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 a
column that identifies the managing server, if one exists, for each listed server. By
sorting or filtering on the column, you can display the set of servers that are
managed by a given server.
Hover help for table links
The Administration Center typically displays Tivoli Storage Manager objects in a
table. In V6.1, when the cursor hovers over an object image, hover-help text is
displayed. The hover help identifies the default action that results when you click
the link that is associated with the object.
Links to information about server messages and Administration
Center messages
When a problem or issue occurs with the server or Administration Center, you are
immediately notified and provided with a brief message about the problem or
issue. The message number is also provided. In V6.1, you can obtain detailed
information about a message by clicking the link that is associated with the
message number. The information is displayed in a new browser window.
Maintenance script enhancements
Tivoli Storage Manager utilizes a maintenance script to perform scheduled
maintenance tasks. In V6.1, you can generate a maintenance script in one of two
styles: predefined and custom.
New for IBM Tivoli Storage Manager Version 6.1 xxi

24. Functions enabled in the V6.1.2 server
A predefined maintenance script is one that is generated through a wizard. This
script contains standard commands that cannot be altered. A predefined script can
only be modified in the wizard.
A custom maintenance script is created using the Administration Center
maintenance script editor. To have more control of your maintenance tasks, you
can modify the commands that you specify. You can also use the editor to update
your 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 search
functions that you can use to find and display information more quickly. When
you select a client node, a summary panel is displayed with the current operation
status, 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 server
processes and sessions. The information is also available in the properties
notebooks for servers.
Centralized server-connection management
In V6.1, server-connection tasks, such as adding a server connection, changing a
password, and creating a server instance, are consolidated in a single location: the
Manage Servers work item, located in the ISC navigation tree.
With actions available in this work item, you can quickly upload server-connection
information to the Administration Center using an XML file. This file can
optionally include a set of server credentials for multiple servers. To help create an
XML file, you can download a list of server connections, without the credential
information.
Changes to management-class activation
In the V6.1, Tivoli Storage Manager no longer activates changes to existing
management classes automatically. You must activate the changes manually. Before
the changes take effect, they are validated. Results of the validation are displayed.
You or another administrator can review them, and then either confirm or cancel
the activation.
Because changes are manually activated, you can prepare the management class in
advance and activate the changes at an appropriate time.
xxii IBM Tivoli Storage Manager for Linux: Administrator’s Reference

25. Functions enabled in the V6.1.2 server
Data deduplication
Data deduplication is a method of eliminating redundant data in sequential-access
disk (FILE) primary, copy, and active-data storage pools. One unique instance of
the data is retained on storage media, and redundant data is replaced with a
pointer to the unique data copy. The goal of deduplication is to reduce the overall
amount of time that is required to retrieve data by letting you store more data on
disk, rather than on tape.
Data deduplication in Tivoli Storage Manager is a two-phase process. In the first
phase, duplicate data is identified. During the second phase, duplicate data is
removed by certain server processes, such as reclamation processing of
storage-pool volumes. By default, a duplicate-identification process begins
automatically after you define a storage pool for deduplication. (If you specify a
duplicate-identification process when you update a storage pool, it also starts
automatically.) Because duplication identification requires extra disk I/O and CPU
resources, Tivoli Storage Manager lets you control when identification begins as
well as the number and duration of processes.
You can deduplicate any type of data except encrypted data. You can deduplicate
client backup and archive data, Tivoli Data Protection data, and so on. Tivoli
Storage Manager can deduplicate whole files as well as files that are members of
an aggregate. You can deduplicate data that has already been stored. No additional
backup, archive, or migration is required.
For optimal efficiency when deduplicating, upgrade to the version 6.1
backup-archive client.
Restriction: You can use the data-deduplication feature with Tivoli Storage
Manager Extended Edition only.
New for IBM Tivoli Storage Manager Version 6.1 xxiii

26. Functions enabled in the V6.1.2 server
Related reference
“DEDUPREQUIRESBACKUP” on page 1159
The DEDUPREQUIRESBACKUP option specifies whether volumes in primary
sequential-access storage pools that are set up for deduplication can be reclaimed
and whether duplicate data can be discarded before the storage pools are backed
up.
“DEFINE STGPOOL (Define a primary storage pool assigned to sequential access
devices)” on page 286
Use this command to define a primary storage pool assigned to sequential access
devices.
“DEFINE STGPOOL (Define a copy storage pool assigned to sequential access
devices)” on page 301
Use this command to define a copy storage pool assigned to sequential access
devices.
“DEFINE STGPOOL (Define an active-data pool assigned to sequential-access
devices)” on page 309
Use this command to define an active-data pool assigned to sequential-access
devices.
“IDENTIFY DUPLICATES (Identify duplicate data in a storage pool)” on page 480
Use this command to start or stop processes that identify duplicate data in a
storage pool. You can specify the number of duplicate-identification processes and
their duration.
“QUERY PROCESS (Query one or more server processes)” on page 719
Use this command to display information on active background processes.
“QUERY STGPOOL (Query storage pools)” on page 771
Use this command to display information about one or more storage pools. You
can also use this command to monitor migration processes for the storage pool.
“UPDATE STGPOOL (Update a primary sequential access pool)” on page 1097
Use this command to update a primary sequential access storage pool.
“UPDATE STGPOOL (Update a copy sequential access storage pool)” on page 1110
Use this command to update a copy sequential access storage pool.
“UPDATE STGPOOL (Update an active-data sequential access)” on page 1116
Use this command to update an active-data pool.
Storage devices
New device support and other changes to storage devices are available in Tivoli
Storage Manager Version 6.1.
Support for HP and Quantum DAT160 drives and media
With Tivoli Storage Manager, you can now use HP and Quantum DAT160 (DDS6)
tape drives and media. New recording formats are available for the 4MM device
type.
Related reference
“DEFINE DEVCLASS (Define a 4MM device class)” on page 149
Use the 4MM device class when you are using 4 mm tape devices.
“UPDATE DEVCLASS (Update a 4MM device class)” on page 978
Use the 4MM device class when you are using 4 mm tape devices.
xxiv IBM Tivoli Storage Manager for Linux: Administrator’s Reference

27. Functions enabled in the V6.1.2 server
Support for Sun StorageTek T10000 drives, T10000B drives, and
T10000 media
With Tivoli Storage Manager, you can now use Sun StorageTek T10000 drives,
T10000B drives, and T10000 media. New recording formats are available for the
ECARTRIDGE device type. Tivoli Storage Manager supports Volsafe media with
the Sun StorageTek T10000 and T10000B drives.
Related reference
“DEFINE DEVCLASS (Define an ECARTRIDGE device class)” on page 165
Use the ECARTRIDGE device class when you are using StorageTek drives such as
the StorageTek SD-3, 9490, 9840 or 9940.
“UPDATE DEVCLASS (Update an ECARTRIDGE device class)” on page 992
Use the ECARTRIDGE device class when you are using StorageTek drives such as
the StorageTek SD-3, 9490, 9840 or 9940.
Disaster recovery manager support for active-data pools
To restore your client systems more quickly and efficiently, you can now use
active-data pools in your recovery plans and procedures.
Active-data pools are storage pools that contain only active versions of client
backup 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 disaster
recovery manager.
v Recycle on-site and off-site active-data pool volumes according to server policies
and processes.
v Include active-data pool volumes in the scripts, macros, and documentation that
is 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 of
installation. Copy storage pools, on the other hand, are processed at installation
time even if you have not explicitly specified a copy storage pool or pools to be
managed.
New for IBM Tivoli Storage Manager Version 6.1 xxv

28. Functions enabled in the V6.1.2 server
Related reference
“MOVE DRMEDIA (Move disaster recovery media offsite and back onsite)” on
page 527
Use this command to track database backup and copy storage pool volumes that
are to be moved offsite and to identify the expired or empty volumes that are to be
moved onsite.
“PREPARE (Create a recovery plan file)” on page 563
Use this command to create a recovery plan file, which contains the information
needed to recover a Tivoli Storage Manager server. You can store a recovery plan
file on a file system that is accessible to the source Tivoli Storage Manager server
or on a target Tivoli Storage Manager server.
“QUERY DRMEDIA (Query disaster recovery media)” on page 628
Use this command to display information about database backup and copy storage
pool volumes. You can also use the command to create a file of executable
commands to process the volumes.
“QUERY DRMSTATUS (Query disaster recovery manager system parameters)” on
page 637
Use this command to display information about the system parameters defined for
disaster recovery manager (DRM).
“SET DRMACTIVEDATASTGPOOL (Specify the active-data pools to be managed
by DRM)” on page 896
Use this command to specify names of the active-data pools to be recovered after a
disaster. Tivoli Storage Manager uses these names if the PREPARE , MOVE
DRMEDIA, or QUERY DRMEDIA command does not include the
ACTIVEDATASTGPOOL parameter.
EXPIRE INVENTORY command enhancements
The 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 specific
client 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 processes
that you want to run within the single EXPIRE INVENTORY process. You can run
up to ten threads at one time, but if you are processing one node, only one thread
is utilized.
Related reference
“EXPIRE INVENTORY (Manually start inventory expiration processing)” on page
407
Use this command to manually start inventory expiration processing. The
inventory expiration process removes client backup and archive file copies from
server storage based on policy specified in the backup and archive copy groups of
the management classes to which the files are bound.
xxvi IBM Tivoli Storage Manager for Linux: Administrator’s Reference

29. Functions enabled in the V6.1.2 server
No-query restore changes
The no-query restore (NQR) function and the internal algorithms responsible for
NQR were changed to take advantage of DB2 capabilities and to improve
performance.
The NQR function has been rewritten to resolve a performance problem
encountered when restoring a small number of objects for a client file system with
a large number of backup objects spread across a large number of Tivoli Storage
Manager server storage pool volumes. NQR performance is now comparable to
that of the classic restore under these conditions. NQR now performs a volume
determination phase that must be completed before any objects are restored from
DISK, FILE, or tape storage volumes.
Server database
Tivoli Storage Manager version 6.1 provides a new server database. Advantages
include automatic statistics collection and database reorganization, full-function
SQL 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 server
database be extracted and then inserted into the new database structure. Tivoli
Storage Manager provides utilities to perform the process.
Support for NetApp SnapMirror to Tape feature
With Tivoli Storage Manager you can create SnapMirror to Tape images of file
systems on NetApp file servers.
SnapMirror to Tape provides an alternative method for backing up very large
NetApp file systems. Because this backup method has limitations, use this method
when copying very large NetApp file systems to secondary storage for disaster
recovery purposes.
Related reference
“BACKUP NODE (Back up a NAS node)” on page 49
Use this command to start a backup operation for a network-attached storage
(NAS) node.
“RESTORE NODE (Restore a NAS node)” on page 849
Use this command to initiate a restore operation for a network-attached storage
(NAS) node.
“QUERY NASBACKUP (Query NAS backup images)” on page 691
Use this command to display information about the file system image objects that
have been backed up for a specific NAS node and file space. You can only use this
command to display objects that were backed up for a NAS node using NDMP.
Reporting and monitoring feature
The reporting and monitoring feature uses a combination of the Tivoli Common
Reporting tool, IBM Tivoli Monitoring, and the IBM Tivoli Data Warehouse to offer
you reports and real time monitoring information about Tivoli Storage Manager
servers and client activity.
New for IBM Tivoli Storage Manager Version 6.1 xxvii

30. Functions enabled in the V6.1.2 server
ODBC driver support
Tivoli 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 enhancements
The Administration Center now displays the backup sets, client nodes, and client
node groups from one portlet.
You can view all of the client nodes, view them by server, or search for a node
from the three available client node tabs. The All Client Nodes tab lists all of the
nodes and has a Filter feature to help in your search. The filter works differently
than the other table filters in the Administration Center, in that here you do not
have to press the Enter key to get results. The search is initiated when you enter a
text character in the filter field. As you add characters, the results are filtered even
more.
When you select a client node, a summary panel is displayed with the current
operation status, server actions, and client node actions. You can also access the
Server 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 All
Client Node Groups tab or from the By Server tab. You can use the filter and the
right-click menu on these pages also.
Backup sets are found in the Backup Set Collections section. Search a server by
selecting it and clicking Update Table.
xxviii IBM Tivoli Storage Manager for Linux: Administrator’s Reference