transcript
- 1. Tivoli Storage Manager for Windows Version 6.2
Administrators Reference SC23-9779-02
- 2. Tivoli Storage Manager for Windows Version 6.2
Administrators Reference SC23-9779-02
- 3. Note: Before using this information and the product it
supports, read the information in Notices on page 1315.| This
edition applies to Version 6.2 of IBM Tivoli Storage Manager
(product numbers 5608-E01, 5608-E02, 5608-E03,| 5608-E07,
5608-E12)), and to all subsequent releases and modifications until
otherwise indicated in new editions or| technical newsletters. This
edition replaces SC23-9779-01. Copyright IBM Corporation 1993,
2010. US Government Users Restricted Rights Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM
Corp.
- 4. Contents Preface . . . . . . . . . . . . . . . xi Specifying
descriptions in keyword parameters 14 Who should read this
publication . . . . . . . xi Controlling command processing . . . .
. . . 14 Publications . . . . . . . . . . . . . . xi Server command
processing . . . . . . . . 14 Tivoli Storage Manager publications .
. . . . xi Cancelling commands . . . . . . . . . . 15 Related
hardware publications . . . . . . . xiii Performing tasks
concurrently on multiple servers 16 Support information . . . . . .
. . . . . xiii Routing commands to a single server. . . . . 16|
Getting technical training . . . . . . . . xiii Routing commands to
multiple servers . . . . 16 Searching knowledge bases . . . . . . .
. xiv Routing commands to a server group. . . . . 17 Contacting IBM
Software Support . . . . . . xv Routing commands to server groups .
. . . . 17 Conventions used in this publication . . . . . xvii
Routing commands to two servers and a server group . . . . . . . .
. . . . . . . 17 New for IBM Tivoli Storage Manager Routing
commands inside scripts . . . . . . 17 Privilege classes for
commands . . . . . . . . 18 Version 6.2. . . . . . . . . . . . .
xix Commands requiring system privilege . . . . 18 New for the
server in Version 6.2 . . . . . . . xix Commands requiring policy
privilege . . . . 21| Client-side data deduplication . . . . . . .
xix Commands requiring storage privilege . . . . 22| Automatic
backup-archive client deployment . . xx Commands requiring operator
privilege . . . . 23| Simultaneous-write operations during storage
Commands any administrator can issue . . . . 24| pool migration . .
. . . . . . . . . . xx| In-flight data encryption using SSL . . . .
. xxi New for the Tivoli Storage Manager reporting Chapter 2.
Administrative commands 27 and monitoring feature in version 6.2 .
. . . xxi ACCEPT DATE (Accepts the current system date) 28| SCSI
passthru support for Windows. . . . . xxii ACTIVATE POLICYSET
(Activate a new policy set) 29| Concurrent read-and-write access to
Centera ASSIGN DEFMGMTCLASS (Assign a default| volumes . . . . . .
. . . . . . . . xxii management class) . . . . . . . . . . . . 31|
The Tivoli Integrated Portal GUI . . . . . . xxii AUDIT commands .
. . . . . . . . . . . 33| The Administration Center not installable
on AUDIT LIBRARY (Audit volume inventories in| HP-UX . . . . . . .
. . . . . . . xxiii an automated library) . . . . . . . . . . 34|
Sun StorageTek T10000B drive encryption . . xxiii AUDIT LICENSES
(Audit server storage usage) 36| MOVESIZETHRESH server option . . .
. . xxiii AUDIT VOLUME (Verify database information| CHECKTAPEPOS
server option to validate for a storage pool volume) . . . . . . .
. 37| data position on tape . . . . . . . . . xxiii BACKUP commands
. . . . . . . . . . . 43 BACKUP DB (Back up the database) . . . . .
44 BACKUP DEVCONFIG (Create backup copies of Chapter 1.
Administering the server device configuration information) . . . .
. . 47 from the command-line interface . . . . 1 BACKUP NODE (Back
up a NAS node) . . . . 49 Issuing commands from the administrative
client . . 1 BACKUP STGPOOL (Back up primary storage Starting and
stopping the administrative client . . 2 pool to copy storage pool)
. . . . . . . . 54 Monitoring server activities from the BACKUP
VOLHISTORY (Save sequential volume administrative client . . . . .
. . . . . . 2 history information) . . . . . . . . . . 58
Monitoring removable-media mounts from the BEGIN EVENTLOGGING
(Begin logging events) . . 60 administrative client . . . . . . . .
. . . 2 CANCEL commands . . . . . . . . . . . 62 Processing
commands one at a time from the CANCEL EXPIRATION (Cancel an
expiration administrative client . . . . . . . . . . . 3 process) .
. . . . . . . . . . . . . 63 Processing a series of commands from
the CANCEL EXPORT (Delete a suspended export administrative client
. . . . . . . . . . . 3 operation) . . . . . . . . . . . . . . 64
Formatting output from commands . . . . . . 4 CANCEL PROCESS
(Cancel an administrative Saving command output to a specified
location . . 4 process) . . . . . . . . . . . . . . 65
Administrative client options . . . . . . . . 5 CANCEL REQUEST
(Cancel one or more mount Issuing commands from the Administration
Center . 7 requests) . . . . . . . . . . . . . . 67 Issuing
commands from the server console . . . . 7 CANCEL RESTORE (Cancel a
restartable restore Entering administrative commands . . . . . . .
8 session). . . . . . . . . . . . . . . 68 Reading syntax diagrams
. . . . . . . . . 8 CANCEL SESSION (Cancel one or more client
Entering long commands . . . . . . . . . 11 sessions) . . . . . . .
. . . . . . . 69 Naming Tivoli Storage Manager objects . . . . 12
CHECKIN LIBVOLUME (Check a storage volume Using wildcard characters
to specify object into a library). . . . . . . . . . . . . . 70
names . . . . . . . . . . . . . . . 13 Copyright IBM Corp. 1993,
2010 iii
- 5. CHECKOUT LIBVOLUME (Check a storage volume DEFINE
RECOVERYMEDIA (Define recoveryout of a library) . . . . . . . . . .
. . . 78 media) . . . . . . . . . . . . . . 260CLEAN DRIVE (Clean a
drive) . . . . . . . . 84 DEFINE SCHEDULE (Define a client or
anCOMMIT (Control committing of commands in a administrative
command schedule) . . . . . 262macro) . . . . . . . . . . . . . . .
. 85 DEFINE SCRIPT (Define a Tivoli StorageCOPY commands . . . . .
. . . . . . . 86 Manager script) . . . . . . . . . . . 285 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). . . . . . 287 pool) . . . . . . . . . . . . . . .
87 DEFINE SERVERGROUP (Define a server COPY CLOPTSET (Copy a client
option set) . . 91 group). . . . . . . . . . . . . . . 292 COPY
DOMAIN (Copy a policy domain) . . . 92 DEFINE SPACETRIGGER (Define
the space COPY MGMTCLASS (Copy a management class) 94 trigger) . .
. . . . . . . . . . . . 293 COPY POLICYSET (Copy a policy set) . .
. . 96 DEFINE STGPOOL (Define a storage pool) . . 296 COPY PROFILE
(Copy a profile) . . . . . . 98 DEFINE SUBSCRIPTION (Define a
profile COPY SCHEDULE (Copy a client or an subscription) . . . . .
. . . . . . . 339 administrative command schedule) . . . . . 100
DEFINE VIRTUALFSMAPPING (Define a COPY SCRIPT (Copy a Tivoli
Storage Manager virtual file space mapping) . . . . . . . . 341
script) . . . . . . . . . . . . . . . 104 DEFINE VOLUME (Define a
volume in a COPY SERVERGROUP (Copy a server group) 105 storage
pool) . . . . . . . . . . . . 343DEFINE commands . . . . . . . . .
. . 106 DELETE commands . . . . . . . . . . . 349 DEFINE
ASSOCIATION (Associate client nodes DELETE ASSOCIATION (Delete the
node with a schedule) . . . . . . . . . . . 107 association to a
schedule) . . . . . . . . 351 DEFINE BACKUPSET (Define a backup
set) . . 109 DELETE BACKUPSET (Delete a backup set) . . 353 DEFINE
CLIENTACTION (Define a one-time DELETE CLIENTOPT (Delete an option
in an client action). . . . . . . . . . . . . 113 option set) . . .
. . . . . . . . . . 357 DEFINE CLIENTOPT (Define an option to an
DELETE CLOPTSET (Delete a client option set) 358 option set) . . .
. . . . . . . . . . 119 DELETE COLLOCGROUP (Delete a collocation
DEFINE CLOPTSET (Define a client option set group). . . . . . . . .
. . . . . . 359 name) . . . . . . . . . . . . . . . 122 DELETE
COLLOCMEMBER (Delete collocation DEFINE COLLOCGROUP (Define a
collocation group member). . . . . . . . . . . . 360 group). . . .
. . . . . . . . . . . 123 DELETE COPYGROUP (Delete a backup or
DEFINE COLLOCMEMBER (Define collocation archive copy group) . . . .
. . . . . . 362 group member). . . . . . . . . . . . 125 DELETE
DATAMOVER (Delete a data mover) 364 DEFINE COPYGROUP (Define a copy
group) 127 DELETE DEVCLASS (Delete a device class) . . 365 DEFINE
DATAMOVER (Define a data mover) 137 DELETE DOMAIN (Delete a policy
domain) 366 DEFINE DEVCLASS (Define a device class) . . 140 DELETE
DRIVE (Delete a drive from a library) 367 DEFINE DOMAIN (Define a
new policy DELETE EVENT (Delete event records). . . . 368 domain) .
. . . . . . . . . . . . . 213 DELETE EVENTSERVER (Delete the
definition DEFINE DRIVE (Define a drive to a library) . . 215 of
the event server) . . . . . . . . . . 370 DEFINE EVENTSERVER
(Define a server as the DELETE FILESPACE (Delete client node data
event server) . . . . . . . . . . . . 219 from the server) . . . .
. . . . . . . 371 DEFINE GRPMEMBER (Add a server to a DELETE
GRPMEMBER (Delete a server from a server group) . . . . . . . . . .
. . 220 server group) . . . . . . . . . . . . 375 DEFINE LIBRARY
(Define a library). . . . . 221 DELETE KEYRING (Delete password
DEFINE MACHINE (Define machine information in the key database) . .
. . . . 376 information for disaster recovery) . . . . . 231 DELETE
LIBRARY (Delete a library). . . . . 377 DEFINE MACHNODEASSOCIATION
DELETE MACHINE (Delete machine (Associate a node with a machine) .
. . . . 233 information) . . . . . . . . . . . . . 378 DEFINE
MGMTCLASS (Define a management DELETE MACHNODEASSOCIATION (Delete
class) . . . . . . . . . . . . . . . 235 association between a
machine and a node) . . 379 DEFINE NODEGROUP (Define a node group)
238 DELETE MGMTCLASS (Delete a management DEFINE NODEGROUPMEMBER
(Define node class) . . . . . . . . . . . . . . . 380 group
member). . . . . . . . . . . . 239 DELETE NODEGROUP (Delete a node
group) 381 DEFINE PATH (Define a path) . . . . . . 240 DELETE
NODEGROUPMEMBER (Delete node DEFINE POLICYSET (Define a policy set)
. . . 248 group member). . . . . . . . . . . . 382 DEFINE
PROFASSOCIATION (Define a profile DELETE PATH (Delete a path) . . .
. . . 383 association) . . . . . . . . . . . . . 250 DELETE
POLICYSET (Delete a policy set) . . . 385 DEFINE PROFILE (Define a
profile) . . . . . 256 DELETE PROFASSOCIATION (Delete a profile
DEFINE RECMEDMACHASSOCIATION association) . . . . . . . . . . . . .
386 (Associate recovery media with a machine) . . 258 DELETE
PROFILE (Delete a profile) . . . . . 389iv IBM Tivoli Storage
Manager for Windows: Administrators Reference
- 6. DELETE RECMEDMACHASSOCIATION HALT (Shut down the server) . .
. . . . . . 499 (Delete recovery media and machine HELP (Get help
on commands and error messages) 501 association) . . . . . . . . .
. . . . 391 IDENTIFY DUPLICATES (Identify duplicate data DELETE
RECOVERYMEDIA (Delete recovery in a storage pool) . . . . . . . . .
. . . 503 media) . . . . . . . . . . . . . . 392 IMPORT commands .
. . . . . . . . . . 507 DELETE SCHEDULE (Delete a client or an
IMPORT ADMIN (Import administrator administrative command schedule)
. . . . . 393 information) . . . . . . . . . . . . . 508 DELETE
SCRIPT (Delete command lines from a IMPORT NODE (Import client node
script or delete the entire script) . . . . . . 396 information) .
. . . . . . . . . . . . 511 DELETE SERVER (Delete a server
definition) 397 IMPORT POLICY (Import policy information) 517
DELETE SERVERGROUP (Delete a server IMPORT SERVER (Import server
information) 520 group). . . . . . . . . . . . . . . 398 INSERT
MACHINE (Insert machine characteristics DELETE SPACETRIGGER (Delete
the storage information or recovery instructions) . . . . . 525
pool space triggers) . . . . . . . . . . 399 ISSUE MESSAGE (Issue a
message from a server DELETE STGPOOL (Delete a storage pool) . .
400 script) . . . . . . . . . . . . . . . . 527 DELETE SUBSCRIBER
(Delete subscriptions LABEL LIBVOLUME (Label a library volume) . .
529 from a configuration manager database) . . . 401 LOCK commands
. . . . . . . . . . . . 535 DELETE SUBSCRIPTION (Delete a profile
LOCK ADMIN (Lock out an administrator) . . 536 subscription) . . .
. . . . . . . . . 402 LOCK NODE (Lock out a client node) . . . .
537 DELETE VIRTUALFSMAPPING (Delete a LOCK PROFILE (Lock a profile)
. . . . . . 538 virtual file space mapping) . . . . . . . . 403
MACRO (Invoke a macro) . . . . . . . . . 540 DELETE VOLHISTORY
(Delete sequential MIGRATE STGPOOL (Migrate storage pool to next
volume history information) . . . . . . . 404 storage pool) . . . .
. . . . . . . . . 542 DELETE VOLUME (Delete a storage pool MOVE
commands . . . . . . . . . . . . 545 volume) . . . . . . . . . . .
. . . 409 MOVE DATA (Move files on a storage poolDISABLE commands .
. . . . . . . . . . 412 volume) . . . . . . . . . . . . . . 546
DISABLE EVENTS (Disable events for event MOVE DRMEDIA (Move
disaster recovery logging) . . . . . . . . . . . . . . 413 media
offsite and back onsite) . . . . . . . 550 DISABLE SESSIONS
(Temporarily prevent client MOVE GRPMEMBER (Move a server group
node access to the server) . . . . . . . . 417 member) . . . . . .
. . . . . . . . 565DISMOUNT command . . . . . . . . . . 419 MOVE
MEDIA (Move sequential access storage DISMOUNT VOLUME (Dismount a
volume by pool media) . . . . . . . . . . . . . 566 volume name) .
. . . . . . . . . . . 420 MOVE NODEDATA (Move data by node in
aDISPLAY OBJNAME (Display a full object name) 421 sequential access
storage pool) . . . . . . 574ENABLE commands . . . . . . . . . . .
422 NOTIFY SUBSCRIBERS (Notify managed servers ENABLE EVENTS
(Enable server or client to update profiles). . . . . . . . . . . .
583 events for logging) . . . . . . . . . . 423 PARALLEL (Run
multiple commands in a script in ENABLE SESSIONS (Resume user
activity on parallel) . . . . . . . . . . . . . . . 584 the server)
. . . . . . . . . . . . . 426 PING SERVER (Test the connection
betweenEND EVENTLOGGING (Stop logging events) . . 428 servers) . .
. . . . . . . . . . . . . 586EXPIRE INVENTORY (Manually start
inventory PREPARE (Create a recovery plan file) . . . . .
587expiration processing) . . . . . . . . . . 430 QUERY commands .
. . . . . . . . . . 593EXPORT commands . . . . . . . . . . . 434
QUERY ACTLOG (Query the activity log) . . . 595 EXPORT ADMIN
(Export administrator QUERY ADMIN (Display administrator
information) . . . . . . . . . . . . . 435 information) . . . . . .
. . . . . . . 600 EXPORT NODE (Export client node QUERY ASSOCIATION
(Query client node information) . . . . . . . . . . . . . 441
associations with a schedule) . . . . . . . 604 EXPORT POLICY
(Export policy information) 459 QUERY AUDITOCCUPANCY (Query client
EXPORT SERVER (Export server information) 465 node storage
utilization). . . . . . . . . 606EXTEND DBSPACE (Increase space for
the QUERY BACKUPSET (Query a backup set) . . 609database) . . . . .
. . . . . . . . . . 481 QUERY BACKUPSETCONTENTS (QueryGENERATE
commands . . . . . . . . . . 482 contents of a backup set) . . . .
. . . . 614 GENERATE BACKUPSET (Generate a backup QUERY CLOPTSET
(Query a client option set) 617 set of a clients data) . . . . . .
. . . . 483 QUERY COLLOCGROUP (Query a collocation GENERATE
BACKUPSETTOC (Generate a table group). . . . . . . . . . . . . . .
619 of contents for a backup set) . . . . . . . 491 QUERY CONTENT
(Query the contents of aGRANT commands . . . . . . . . . . . 493
storage pool volume) . . . . . . . . . . 622 GRANT AUTHORITY (Add
administrator QUERY COPYGROUP (Query copy groups) . . 630
authority) . . . . . . . . . . . . . 494 QUERY DATAMOVER (Display
data mover GRANT PROXYNODE (Grant proxy authority definitions) . .
. . . . . . . . . . . 635 to a client node) . . . . . . . . . . .
498 QUERY DB (Display database information) . . 638 Contents v
- 7. QUERY DBSPACE (Display database storage QUERY RPFILE (Query
recovery plan file space) . . . . . . . . . . . . . . . 641
information stored on a target server) . . . . 762 QUERY DEVCLASS
(Display information on QUERY SAN (Query the devices on the SAN)
765 one or more device classes). . . . . . . . 642 QUERY SCHEDULE
(Query schedules). . . . 768 QUERY DIRSPACE (Query storage
utilization of QUERY SCRIPT (Query Tivoli Storage Manager FILE
directories) . . . . . . . . . . . 646 scripts) . . . . . . . . . .
. . . . 776 QUERY DOMAIN (Query a policy domain) . . 647 QUERY
SERVER (Query a server) . . . . . 779 QUERY DRIVE (Query
information about a QUERY SERVERGROUP (Query a server group) 783
drive) . . . . . . . . . . . . . . . 650 QUERY SESSION (Query
client sessions) . . . 785 QUERY DRMEDIA (Query disaster recovery
QUERY SHREDSTATUS (Query shredding media) . . . . . . . . . . . . .
. 654 status ) . . . . . . . . . . . . . . 789 QUERY DRMSTATUS
(Query disaster recovery QUERY SPACETRIGGER (Query the space
manager system parameters) . . . . . . . 663 triggers) . . . . . .
. . . . . . . . 791 QUERY ENABLED (Query enabled events) . . 666 |
QUERY SSLKEYRINGPW (Query SSL key QUERY EVENT (Query scheduled and
| database file password) . . . . . . . . . 793 completed events) .
. . . . . . . . . . 668 QUERY STATUS (Query system parameters) 794
QUERY EVENTRULES (Query rules for server QUERY STGPOOL (Query
storage pools) . . . 800 or client events) . . . . . . . . . . .
680 QUERY SUBSCRIBER (Display subscriber QUERY EVENTSERVER (Query
the event information) . . . . . . . . . . . . . 811 server). . . .
. . . . . . . . . . . 683 QUERY SUBSCRIPTION (Display subscription
QUERY EXPORT (Query for active or information) . . . . . . . . . .
. . . 813 suspended export operations) . . . . . . . 684 QUERY
SYSTEM (Query the system QUERY FILESPACE (Query one or more file
configuration and capacity). . . . . . . . 815 spaces) . . . . . .
. . . . . . . . 691 QUERY TAPEALERTMSG (Display status of QUERY
LIBRARY (Query a library) . . . . . 696 SET TAPEALERTMSG command) .
. . . . 817 QUERY LIBVOLUME (Query a library volume) 699 QUERY TOC
(Display table of contents for a QUERY LICENSE (Display license
information) 702 backup image) . . . . . . . . . . . . 818 QUERY
LOG (Display information on the QUERY VIRTUALFSMAPPING (Query a
virtual recovery log) . . . . . . . . . . . . 703 file space
mapping) . . . . . . . . . . 821 QUERY MACHINE (Query machine QUERY
VOLHISTORY (Display sequential information) . . . . . . . . . . . .
. 705 volume history information) . . . . . . . 823 QUERY MEDIA
(Query sequential access QUERY VOLUME (Query storage pool storage
pool media) . . . . . . . . . . 708 volumes) . . . . . . . . . . .
. . . 829 QUERY MGMTCLASS (Query a management QUIT (End the
interactive mode of the class) . . . . . . . . . . . . . . . 714
administrative client) . . . . . . . . . . . 836 QUERY MOUNT
(Display information on RECLAIM STGPOOL (Reclaim volumes in a
mounted sequential access volumes). . . . . 717 sequential-access
storage pool) . . . . . . . 837 QUERY NASBACKUP (Query NAS backup
RECONCILE VOLUMES (Reconcile differences in images) . . . . . . . .
. . . . . . 718 the virtual volume definitions) . . . . . . . 840
QUERY NODE (Query nodes) . . . . . . . 722 REGISTER commands . . .
. . . . . . . 843 QUERY NODEDATA (Query client data in REGISTER
ADMIN (Register an administrator) 844 volumes) . . . . . . . . . .
. . . . 730 REGISTER LICENSE (Register a new license) 846 QUERY
NODEGROUP (Query a node group) 733 REGISTER NODE (Register a node)
. . . . . 848 QUERY OCCUPANCY (Query client file spaces REMOVE
commands . . . . . . . . . . . 859 in storage pools) . . . . . . .
. . . . 735 REMOVE ADMIN (Delete an administrator) . . 860 QUERY
OPTION (Query server options) . . . 739 REMOVE NODE (Delete a node
or an QUERY PATH (Display a path definition) . . . 740 associated
machine node) . . . . . . . . 861 QUERY POLICYSET (Query a policy
set) . . . 744 RENAME commands . . . . . . . . . . . 863 QUERY
PROCESS (Query one or more server RENAME ADMIN (Rename an
administrator) 864 processes) . . . . . . . . . . . . . 747 RENAME
FILESPACE (Rename a client file QUERY PROFILE (Query a profile) . .
. . . 749 space on the server) . . . . . . . . . . 865 QUERY
PROXYNODE (Query proxy authority RENAME NODE (Rename a node) . . .
. . 868 for a client node) . . . . . . . . . . . 752 RENAME SCRIPT
(Rename a Tivoli Storage QUERY RECOVERYMEDIA (Query recovery
Manager script) . . . . . . . . . . . 869 media) . . . . . . . . .
. . . . . 753 RENAME SERVERGROUP (Rename a server QUERY REQUEST
(Query one or more pending group). . . . . . . . . . . . . . . 870
mount requests) . . . . . . . . . . . 756 RENAME STGPOOL (Change
the name of a QUERY RESTORE (Query restartable restore storage
pool) . . . . . . . . . . . . 871 sessions) . . . . . . . . . . . .
. . 757 REPLY (Allow a request to continue processing) 872 QUERY
RPFCONTENT (Query recovery plan RESET PASSEXP (Reset password
expiration) . . 873 file contents stored on a target server) . . .
. 760vi IBM Tivoli Storage Manager for Windows: Administrators
Reference
- 8. RESTART EXPORT (Restart a suspended export SET
DRMNOTMOUNTABLENAME (Specify the operation) . . . . . . . . . . . .
. . 875 not mountable location name) . . . . . . . 938 RESTORE
commands. . . . . . . . . . . 877 SET DRMPLANPREFIX (Specify a
prefix for RESTORE NODE (Restore a NAS node) . . . 878 recovery
plan file names) . . . . . . . . 939 RESTORE STGPOOL (Restore
storage pool data SET DRMPLANVPOSTFIX (Specify replacement from a
copy pool or an active-data pool) . . . 883 volume names) . . . . .
. . . . . . . 941 RESTORE VOLUME (Restore primary volume SET
DRMPRIMSTGPOOL (Specify the primary data from a copy pool or an
active-data pool) . 887 storage pools to be managed by DRM) . . . .
942 REVOKE commands . . . . . . . . . . . 892 SET DRMRPFEXPIREDAYS
(Set criteria for REVOKE AUTHORITY (Remove administrator recovery
plan file expiration) . . . . . . . 943 authority) . . . . . . . .
. . . . . 893 SET DRMVAULTNAME (Specify the vault REVOKE PROXYNODE
(Revoke proxy name) . . . . . . . . . . . . . . . 945 authority for
a client node) . . . . . . . . 897 SET EVENTRETENTION (Set the
retention ROLLBACK (Rollback uncommitted changes in a period for
event records) . . . . . . . . 946 macro). . . . . . . . . . . . .
. . . 898 SET INVALIDPWLIMIT (Set the number of RUN (Run a Tivoli
Storage Manager script) . . . 899 invalid logon attempts) . . . . .
. . . . 947 SELECT (Perform an SQL query of the IBM Tivoli SET
LICENSEAUDITPERIOD (Set license audit Storage Manager database) . .
. . . . . . . 902 period) . . . . . . . . . . . . . . 948 SERIAL
(Run multiple commands in a script in SET MAXCMDRETRIES (Set the
maximum serial) . . . . . . . . . . . . . . . . 909 number of
command retries) . . . . . . . 949 SET commands . . . . . . . . . .
. . . 910 SET MAXSCHEDSESSIONS (Set maximum SET ACCOUNTING (Set
accounting records on scheduled sessions) . . . . . . . . . . 950
or off) . . . . . . . . . . . . . . . 912 SET MINPWLENGTH (Set
minimum password SET ACTLOGRETENTION (Set the retention length) . .
. . . . . . . . . . . . 951 period or the size of the activity log)
. . . . 913 SET PASSEXP (Set password expiration date) 952 SET
ARCHIVERETENTIONPROTECTION SET QUERYSCHEDPERIOD (Set query period
(Activate data retention protection) . . . . . 915 for polling
client nodes) . . . . . . . . . 954 SET AUTHENTICATION (Set
password SET RANDOMIZE (Set randomization of authentication) . . .
. . . . . . . . . 917 scheduled start times) . . . . . . . . . 955
SET CLIENTACTDURATION (Set the duration SET REGISTRATION (Set open
or closed period for the client action). . . . . . . . 918
registration) . . . . . . . . . . . . . 957 SET CONFIGMANAGER
(Specify a SET RETRYPERIOD (Set time between retry configuration
manager) . . . . . . . . . 919 attempts) . . . . . . . . . . . . .
. 959 SET CONFIGREFRESH (Set managed server SET SCHEDMODES (Select
a central scheduling configuration refresh). . . . . . . . . . 920
mode) . . . . . . . . . . . . . . . 960 SET CONTEXTMESSAGING (Set
message SET SERVERHLADDRESS (Set the high-level context reporting
on or off) . . . . . . . . 921 address of a server) . . . . . . . .
. . 962 SET CROSSDEFINE (Specifies whether to SET SERVERLLADDRESS
(Set the low-level cross-define servers) . . . . . . . . . . 922
address of a server) . . . . . . . . . . 963 SET DBRECOVERY (Set
the device class for SET SERVERNAME (Specify the server name) 964
automatic backups) . . . . . . . . . . 923 SET SERVERPASSWORD (Set
password for SET DBREPORTMODE (Set the level of server). . . . . .
. . . . . . . . . 965 database reporting) . . . . . . . . . . 924 |
SET SSLKEYRINGPW (Set the SSL key ring| SET DEDUPVERIFICATIONLEVEL
(Set the | password) . . . . . . . . . . . . . 966| percentage of
extents to verify) . . . . . . 925 SET SUBFILE (Set subfile backup
for client SET DRMACTIVEDATASTGPOOL (Specify the nodes) . . . . . .
. . . . . . . . . 967 active-data pools to be managed by DRM) . .
927 SET SUMMARYRETENTION (Set number of SET DRMCHECKLABEL (Specify
label days to keep data in activity summary table) . . 968
checking) . . . . . . . . . . . . . . 929 SET TAPEALERTMSG (Set
tape alert messages SET DRMCMDFILENAME (Specify the name of on or
off) . . . . . . . . . . . . . . 969 a file to contain commands) .
. . . . . . 930 SET TOCLOADRETENTION (Set load retention SET
DRMCOPYSTGPOOL (Specify the copy period for table of contents) . .
. . . . . 970 storage pools to be managed by DRM) . . . . 931
SETOPT (Set a server option for dynamic update) 971 SET
DRMCOURIERNAME (Specify the courier SHRED DATA (Shred data). . . .
. . . . . 973 name) . . . . . . . . . . . . . . . 932 SUSPEND
EXPORT (Suspend a currently running SET DRMDBBACKUPEXPIREDAYS
(Specify DB export operation) . . . . . . . . . . . . 975 backup
series expiration) . . . . . . . . 933 UNLOCK commands . . . . . .
. . . . . 976 SET DRMFILEPROCESS (Specify file UNLOCK ADMIN (Unlock
an administrator) 977 processing) . . . . . . . . . . . . . 935
UNLOCK NODE (Unlock a client node) . . . 978 SET DRMINSTRPREFIX
(Specify the prefix for UNLOCK PROFILE (Unlock a profile) . . . .
979 recovery instructions file names) . . . . . . 936 UPDATE
commands . . . . . . . . . . . 980 Contents vii
- 9. UPDATE ADMIN (Update an administrator) 981 Date, number,
time, and language options . . 1190 UPDATE BACKUPSET (Update a
retention Database options . . . . . . . . . . . 1191 value
assigned to a backup set) . . . . . . 983 Data transfer options . .
. . . . . . . 1191 UPDATE CLIENTOPT (Update a client option Message
options . . . . . . . . . . . 1191 sequence number) . . . . . . . .
. . . 988 Event logging options . . . . . . . . . 1192 UPDATE
CLOPTSET (Update a client option set Security options and licensing
options. . . . 1192 description) . . . . . . . . . . . . . 989
Miscellaneous options . . . . . . . . . 1193 UPDATE COLLOCGROUP
(Update a 3494SHARED . . . . . . . . . . . . . 1194 collocation
group) . . . . . . . . . . . 990 ACSACCESSID . . . . . . . . . . .
. 1195 UPDATE COPYGROUP (Update a copy group) 991 ACSLOCKDRIVE. . .
. . . . . . . . . 1196 UPDATE DATAMOVER (Update a data mover) 999
ACSQUICKINIT . . . . . . . . . . . . 1197 UPDATE DEVCLASS (Update
the attributes of ACSTIMEOUTX . . . . . . . . . . . . 1198 a device
class) . . . . . . . . . . . . 1001 ACTIVELOGDIR . . . . . . . . .
. . . 1199 UPDATE DOMAIN (Update a policy domain) 1066
ACTIVELOGSIZE . . . . . . . . . . . 1200 UPDATE DRIVE (Update a
drive) . . . . . 1068 ADMINONCLIENTPORT . . . . . . . . . 1201
UPDATE LIBRARY (Update a library) . . . . 1072 ADREGISTER . . . . .
. . . . . . . . 1202 UPDATE LIBVOLUME (Change the status of a
ADSETDC . . . . . . . . . . . . . . 1203 storage volume) . . . . .
. . . . . . 1077 ADSMGROUPNAME . . . . . . . . . . 1204 UPDATE
MACHINE (Update machine ADUNREGISTER . . . . . . . . . . . 1205
information) . . . . . . . . . . . . 1079 ALIASHALT . . . . . . . .
. . . . . 1206 UPDATE MGMTCLASS (Update a ARCHFAILOVERLOGDIR . . .
. . . . . 1207 management class) . . . . . . . . . . 1081
ARCHLOGDIR . . . . . . . . . . . . 1208 UPDATE NODE (Update node
attributes) . . 1084 ASSISTVCRRECOVERY . . . . . . . . . 1209
UPDATE NODEGROUP (Update a node AUDITSTORAGE . . . . . . . . . . .
1210 group) . . . . . . . . . . . . . . 1093 | CHECKTAPEPOS . . . .
. . . . . . . 1211 UPDATE PATH (Change a path) . . . . . 1094 |
CLIENTDEDUPTXNLIMIT . . . . . . . . 1212 UPDATE POLICYSET (Update a
policy set COMMMETHOD . . . . . . . . . . . 1214 description) . . .
. . . . . . . . . 1100 COMMTIMEOUT . . . . . . . . . . . 1215
UPDATE PROFILE (Update a profile DATEFORMAT . . . . . . . . . . . .
1216 description) . . . . . . . . . . . . 1102 DBMEMPERCENT . . . .
. . . . . . . 1217 UPDATE RECOVERYMEDIA (Update recovery
DEDUPREQUIRESBACKUP . . . . . . . . 1218 media) . . . . . . . . . .
. . . . 1103 DEVCONFIG . . . . . . . . . . . . . 1219 UPDATE
SCHEDULE (Update a schedule) 1105 DISABLESCHEDS . . . . . . . . . .
. 1220 UPDATE SCRIPT (Update a Tivoli Storage DISKSTGPOOLMEMSIZE .
. . . . . . . . 1220 Manager script) . . . . . . . . . . . 1127
DISPLAYLFINFO. . . . . . . . . . . . 1221 UPDATE SERVER (Update a
server defined for DNSLOOKUP . . . . . . . . . . . . . 1222
server-to-server communications) . . . . . 1129 DRIVEACQUIRERETRY .
. . . . . . . . 1223 UPDATE SERVERGROUP (Update a server
EVENTSERVER . . . . . . . . . . . . 1224 group description) . . . .
. . . . . . 1133 EXPINTERVAL . . . . . . . . . . . . 1225 UPDATE
SPACETRIGGER (Update the space EXPQUIET . . . . . . . . . . . . . .
1226 triggers) . . . . . . . . . . . . . . 1134 FILEEXIT . . . . .
. . . . . . . . . 1227 UPDATE STGPOOL (Update a storage pool) 1136
FILETEXTEXIT . . . . . . . . . . . . 1228 UPDATE VIRTUALFSMAPPING
(Update a IDLETIMEOUT . . . . . . . . . . . . 1229 virtual file
space mapping) . . . . . . . 1172 LANGUAGE . . . . . . . . . . . .
. 1230 UPDATE VOLHISTORY (Update sequential MAXSESSIONS . . . . . .
. . . . . . 1232 volume history information) . . . . . . . 1174
MESSAGEFORMAT . . . . . . . . . . . 1233 UPDATE VOLUME (Change a
storage pool MIRRORLOGDIR . . . . . . . . . . . 1234 volume) . . .
. . . . . . . . . . . 1176 MOVEBATCHSIZE . . . . . . . . . . .
1235VALIDATE commands . . . . . . . . . . 1180 MOVESIZETHRESH . . .
. . . . . . . 1236 VALIDATE LANFREE (Validate LAN-Free MSGINTERVAL
. . . . . . . . . . . . 1237 paths) . . . . . . . . . . . . . .
1181 NAMEDPIPENAME . . . . . . . . . . 1238 VALIDATE POLICYSET
(Verify a policy set) 1183 NDMPCONTROLPORT . . . . . . . . .
1239VARY (Bring a random access volume online or NDMPPORTRANGE . .
. . . . . . . . 1240offline) . . . . . . . . . . . . . . . 1185
NDMPPREFDATAINTERFACE . . . . . . . 1241 NOPREEMPT . . . . . . . .
. . . . . 1242Chapter 3. Server options . . . . . 1187
NORETRIEVEDATE. . . . . . . . . . . 1243Modifying server options .
. . . . . . . . 1187 NPAUDITFAILURE . . . . . . . . . . . 1244Types
of server options . . . . . . . . . . 1188 NPAUDITSUCCESS . . . . .
. . . . . . 1245 Server communication options . . . . . . 1188
NPBUFFERSIZE . . . . . . . . . . . . 1246 Server storage options .
. . . . . . . . 1189 NUMBERFORMAT . . . . . . . . . . . 1247
Client-server options . . . . . . . . . 1190 NUMOPENVOLSALLOWED. .
. . . . . . 1248viii IBM Tivoli Storage Manager for Windows:
Administrators Reference
- 10. QUERYAUTH . . . . . . . . . . . . . 1250 VOLUMEHISTORY . .
. . . . . . . . . 1290 RECLAIMDELAY . . . . . . . . . . . 1251
RECLAIMPERIOD . . . . . . . . . . . 1252 Chapter 4. Server
utilities. . . . . . 1291 REPORTRETRIEVE . . . . . . . . . . . 1253
DSMMAXSG (Increase the block size for writing REQSYSAUTHOUTFILE . .
. . . . . . . 1254 data) . . . . . . . . . . . . . . . . 1292
RESOURCETIMEOUT . . . . . . . . . . 1255 DSMSERV (Start the server)
. . . . . . . . 1293 RESTOREINTERVAL . . . . . . . . . . 1256
DSMSERV DISPLAY DBSPACE (Display RETENTIONEXTENSION . . . . . . . .
. 1257 information about database storage space) . . . 1294
SANDISCOVERY. . . . . . . . . . . . 1258 DSMSERV DISPLAY LOG
(Display recovery log SANDISCOVERYTIMEOUT . . . . . . . . 1259
information) . . . . . . . . . . . . . 1295 SANREFRESHTIME . . . .
. . . . . . . 1260 DSMSERV FORMAT (Format the database and
SEARCHMPQUEUE. . . . . . . . . . . 1261 log) . . . . . . . . . . .
. . . . . 1297 SECUREPIPES. . . . . . . . . . . . . 1262 DSMSERV
INSERTDB (Move a server database| SERVERDEDUPTXNLIMIT . . . . . . .
. 1263 into an empty database) . . . . . . . . . 1299 SHMPORT . . .
. . . . . . . . . . . 1265 DSMSERV LOADFORMAT (Format a database)
1301 SHREDDING . . . . . . . . . . . . . 1266 DSMSERV REMOVEDB
(Remove a database) 1303 SNMPHEARTBEATINTERVAL . . . . . . . 1267
DSMSERV RESTORE DB (Restore the database) 1304 SNMPMESSAGECATEGORY
. . . . . . . . 1268 DSMSERV RESTORE DB (Restore a database to
SNMPSUBAGENT . . . . . . . . . . . 1269 its most current state) . .
. . . . . . . 1305 SNMPSUBAGENTHOST . . . . . . . . . 1270 DSMSERV
RESTORE DB (Restore a database to SNMPSUBAGENTPORT . . . . . . . .
. 1271 a point-in-time) . . . . . . . . . . . 1307 SSLTCPADMINPORT
. . . . . . . . . . 1272 DSMSERV UPDATE (Create registry entries
for a SSLTCPPORT . . . . . . . . . . . . . 1273 server instance) .
. . . . . . . . . . . 1310 TCPADMINPORT . . . . . . . . . . . 1274
TCPNODELAY . . . . . . . . . . . . 1275 Appendix A. Return codes
for use in TCPPORT . . . . . . . . . . . . . . 1276 TCPWINDOWSIZE .
. . . . . . . . . . 1277 IBM Tivoli Storage Manager scripts . 1311
TECBEGINEVENTLOGGING . . . . . . . 1278 TECHOST . . . . . . . . . .
. . . . 1279 Appendix B. Accessibility features TECPORT . . . . . .
. . . . . . . . 1280 for Tivoli Storage Manager . . . . . 1313
TECUTF8EVENT . . . . . . . . . . . . 1281 THROUGHPUTDATATHRESHOLD .
. . . . 1282 Notices . . . . . . . . . . . . . 1315
THROUGHPUTTIMETHRESHOLD . . . . . 1283 Trademarks . . . . . . . . .
. . . . 1317 TIMEFORMAT . . . . . . . . . . . . 1284 TXNGROUPMAX .
. . . . . . . . . . 1285 UNIQUETDPTECEVENTS . . . . . . . . 1286
Glossary . . . . . . . . . . . . . 1319 UNIQUETECEVENTS . . . . . .
. . . . 1287 USEREXIT . . . . . . . . . . . . . . 1288 Index . . .
. . . . . . . . . . . 1341 VERBCHECK . . . . . . . . . . . . . 1289
Contents ix
- 11. x IBM Tivoli Storage Manager for Windows: Administrators
Reference
- 12. 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 IBM 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/v6r2. 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/.| Go to Tivoli
Documentation Central to find information centers that contain
official| product documentation for current and previous versions
of Tivoli products,| including Tivoli Storage Manager products at
http://www.ibm.com/|
developerworks/wikis/display/tivolidoccentral/Tivoli+Storage+Manager.|
You can also order some related publications from the IBM
Publications Center| Web site. The Web site provides information
about ordering publications from| countries other than the United
States. In the United States, you can order| publications by
calling 1-800-879-2755. Tivoli Storage Manager publications
Publications are available for the server, storage agent, client,
and Data Protection.| Table 1. IBM Tivoli Storage Manager
troubleshooting and tuning publications| Publication title Order
number| IBM Tivoli Storage Manager Client Messages and Application
SC27-2877| Programming Interface Return Codes| IBM Tivoli Storage
Manager Server Messages and Error Codes SC27-2878 Copyright IBM
Corp. 1993, 2010 xi
- 13. | Table 1. IBM Tivoli Storage Manager troubleshooting and
tuning publications (continued)| Publication title Order number|
IBM Tivoli Storage Manager Performance Tuning Guide GC23-9788| IBM
Tivoli Storage Manager Problem Determination Guide GC23-9789| Table
2. Tivoli Storage Manager server publications Publication title
Order number 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 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 Integration Guide for Tivoli
Storage SC27-2828 Manager FastBack Table 3. Tivoli Storage Manager
storage agent publications Publication title Order number IBM
Tivoli Storage Manager for SAN for AIX Storage Agent Users
SC23-9797 Guide IBM Tivoli Storage Manager for SAN for HP-UX
Storage Agent Users SC23-9798 Guide IBM Tivoli Storage Manager for
SAN for Linux Storage Agent Users SC23-9799 Guide IBM Tivoli
Storage Manager for SAN for Sun Solaris Storage Agent SC23-9800
Users Guide IBM Tivoli Storage Manager for SAN for Windows Storage
Agent Users SC23-9553 Guide Table 4. Tivoli Storage Manager client
publications Publication title Order number IBM Tivoli Storage
Manager for UNIX and Linux: Backup-Archive SC23-9791 Clients
Installation and Users Guide IBM Tivoli Storage Manager for
Windows: Backup-Archive Clients SC23-9792 Installation and Users
Guide xii IBM Tivoli Storage Manager for Windows: Administrators
Reference
- 14. Table 4. Tivoli Storage Manager client publications
(continued) Publication title Order number IBM Tivoli Storage
Manager for Space Management for UNIX and Linux: SC23-9794 Users
Guide| IBM Tivoli Storage Manager Using the Application Programming
SC23-9793| Interface Table 5. Tivoli Storage Manager Data
Protection publications Publication title Order number IBM Tivoli
Storage Manager for Enterprise Resource Planning: Data SC33-6341
Protection for SAP Installation and Users Guide for DB2 IBM Tivoli
Storage Manager for Enterprise Resource Planning: Data SC33-6340
Protection for SAP Installation and Users Guide for Oracle 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 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 information You can find support information for
IBM products from various sources. Start at the IBM Support Portal:
http://www.ibm.com/support/entry/portal/. You can select the
products that you are interested in, and search for a wide variety
of relevant information.| Getting technical training| Information
about Tivoli technical training courses is available online.| Go to
these Web sites for training information:| Tivoli software training
and certification| Choose from instructor led, online classroom
training, self-paced Web| classes, Tivoli certification
preparation, and other training options at this| site:
http://www.ibm.com/software/tivoli/education/| Tivoli Support
Technical Exchange| Technical experts share their knowledge and
answer your questions in| these webcasts:
http://www.ibm.com/software/sysmgmt/products/|
support/supp_tech_exch.html Preface xiii
- 15. Searching knowledge bases If you have a problem with IBM
Tivoli Storage Manager, there are several knowledge bases that you
can search. Begin by searching the Tivoli Storage Manager
Information Center at
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2. From this
Web site, you can search the current Tivoli Storage Manager
documentation. Searching the Internet If you cannot find an answer
to your question in the Tivoli Storage Manager Information Center,
search the Internet for the 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/support/entry/portal/Overview/Software/|
Tivoli/Tivoli_Storage_Manager.| You can search for information
without signing in. Sign in using your IBM ID and| password, if you
want to customize the site based on your product usage and|
information needs. If you do not already have an IBM ID and
password, click Sign| in at the top of the page and follow the
instructions to register. From the Support Web site, you can search
various resources including:| v IBM technotes| v IBM downloads| v
IBM Redbooks publications| v IBM Authorized Program Analysis
Reports (APARs) Select the product and click Downloads to search
the APAR list. If you still cannot find a solution to the problem,
you can search forums and newsgroups on the Internet for the latest
information that might help you resolve your problem.| An
independent user discussion list, ADSM-L, is hosted by Marist
College. You can| subscribe by sending an e-mail to
listserv@vm.marist.edu. The body of the message| must contain the
following text: SUBSCRIBE ADSM-L your_first_name|
your_family_name.| To share your experiences and learn from others
in the Tivoli Storage Manager| user community, go to the Tivoli
Storage Manager wiki at http://www.ibm.com/|
developerworks/wikis/display/tivolistoragemanager. Using IBM
Support Assistant| IBM Support Assistant is a complimentary
software product that helps you with| problem determination. You
can install the stand-alone IBM Support Assistant| application on
any workstation. You can then enhance the application by
installing| product-specific plug-in modules for the IBM products
that you use. 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. For more
information, see the IBM Support Assistant Web site at
http://www.ibm.com/software/support/isa/. xiv IBM Tivoli Storage
Manager for Windows: Administrators Reference
- 16. 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| Find add-ons for specific
products here: http://www.ibm.com/support/|
docview.wss?&uid=swg27012689. 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 IBM Software Support| Web site at
http://www.ibm.com/support/entry/portal/.| v If you previously
customized the site based on your product usage:| 1. Click the link
for your Tivoli Storage Manager product, or one of the other|
Tivoli Storage Manager components that you want to find a fix for.|
2. Click Downloads, and then click Fixes by version.| v If you have
not customized the site based on your product usage, click|
Downloads and search for your product.| Receiving notification of
product fixes| You can receive notifications about fixes, flashes,
upgrades, and other news about| IBM products.| To sign up to
receive notifications about IBM products, follow these steps:| 1.
From the support page at http://www.ibm.com/support/entry/portal/,
click| My notifications in the notifications module.| 2. Sign in
using your IBM ID and password. If you do not have an ID and|
password, click register now above the IBM ID and password.| 3.
Click the Subscribe tab to select your product family and click
Continue.| 4. Select the type of information that you want to
receive, and add your personal| preferences. You can specify how
you want to be notified, how often, and you| can also optionally
select a folder for the notifications.| 5. Click Submit.| 6. For
notifications for other products, repeat steps 4 and 5.| Tip: You
can also pick a product first, from the main support portal site,
and| then click in the Notifications section to create or update
your subscription for| that product.| Contacting IBM Software
Support| You can contact IBM Software Support if you have an active
IBM subscription and| support contract and if you are authorized to
submit problems to IBM. Before you contact IBM Software Support,
follow these steps: 1. Set up a subscription and support contract.
2. Determine the business impact of your problem. 3. Describe your
problem and gather background information. Preface xv
- 17. Then see Submitting the problem to IBM Software Support on
page xvii for information on contacting IBM Software Support.
Setting up a subscription and support contract| Set up a
subscription and support contract. The type of contract that you
need| depends on the type of product you have.| For IBM distributed
software products (including, but not limited to, IBM 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:| v
Online: Go to the Passport Advantage Web page at
http://www.ibm.com/| software/lotus/passportadvantage/, click How
to enroll, and follow the| instructions.| v By Phone: You can call
1-800-IBMSERV (1-800-426-7378) in the United States, or| 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. Determining the business
impact When you report a problem to IBM, you are asked to supply a
severity level. Therefore, you must 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. Describing 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 using a workaround for this
problem? If so, be prepared to explain it| when you report the
problem. xvi IBM Tivoli Storage Manager for Windows: Administrators
Reference
- 18. Submitting 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/|
support/entry/portal/Open_service_request/Software/|
Software_support_(general). Sign in to access IBM Service Requests,
and| enter your information into the 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. Conventions used in this
publication v Command to be entered on the Windows 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
- 19. xviii IBM Tivoli Storage Manager for Windows:
Administrators Reference
- 20. New for IBM Tivoli Storage Manager Version 6.2 Many
features in the Tivoli Storage Manager Version 6.2 server are new
for previous Tivoli Storage Manager users. New for the server in
Version 6.2 Tivoli Storage Manager server Version 6.2 contains many
new features and changes. Any updates that have been made to the
information since the previous edition are marked with a vertical
bar ( | ) in the left margin.| Client-side data deduplication| In
client-side data deduplication, the Tivoli Storage Manager
backup-archive client| and the server work together to identify
duplicate data.| Data deduplication is a method of reducing storage
needs by eliminating| redundant data. In Tivoli Storage Manager
V6.1, only the server could identify and| remove redundant data. In
V6.2, you have the option of identifying and removing| redundant
data during backup and archive processing before data is sent to
the| server. This method of data deduplication is called
client-side data deduplication. It is| available with V6.2
backup-archive clients and the V6.2 Tivoli Storage Manager|
application programming interface (API).| Client-side data
deduplication provides several advantages to server-side data|
deduplication. Client-side data deduplication reduces the amount of
data sent over| the local area network (LAN). In addition, the
processing power that is required to| identify duplicate data is
offloaded from the server to client nodes. The processing| that is
required to remove duplicate data on the server is eliminated.
Space savings| occur immediately.| If you used server-side data
deduplication, V6.2 client nodes can access existing| deduplicated
data and storage pools that are already set up for data
deduplication.| When restoring or retrieving files, the client node
queries for and displays files as| it normally does. If a user
selects a file that exists in a deduplicated storage pool,| the
server manages the work of reconstructing the file.| You enable
client-side data deduplication using a combination of settings on
the| client node and the server. The primary storage pool that is
specified by the copy| group of the management class associated
with the client data must be a| sequential-access disk (FILE)
storage pool that is enabled for data deduplication. Copyright IBM
Corp. 1993, 2010 xix
- 21. Client-side data deduplication: Changes for V6.2| Related
reference| CLIENTDEDUPTXNLIMIT on page 1212| Use this option to
specify the maximum size of a transaction when client-side|
deduplicated data is backed up or archived.| QUERY CONTENT (Query
the contents of a storage pool volume) on page 622| Use this
command to identify files that are linked to files on other volumes
in a| deduplicated storage pool.| REGISTER NODE (Register a node)
on page 848| Use this command to register a node to the server.|
SERVERDEDUPTXNLIMIT on page 1263| Use this option to specify the
maximum size of objects that can be deduplicated on| the server.|
SET DEDUPVERIFICATIONLEVEL (Set the percentage of extents to
verify) on| page 925| Use this command to verify extents sent to
the server during client-side| deduplication.| UPDATE NODE (Update
node attributes) on page 1084| Use this command to modify the
attributes of a registered node.| Automatic backup-archive client
deployment| IBM Tivoli Storage Manager V6.2 can deploy
backup-archive client code to| workstations that already have the
backup-archive client installed.| You can now deploy backup-archive
client code to candidate client workstations| from the Tivoli
Storage Manager V6.2 Administration Center. From the|
Administration Center, you can coordinate the client updates to
each workstation| that is at release 5.4 and later to V6.2. You are
helped through the process by| wizards that configure your
workstation and schedule the deployments. The| backup-archive
client deployment feature is available for Windows backup-archive|
clients only.| Simultaneous-write operations during storage pool
migration| With Tivoli Storage Manager, you can now write data
simultaneously to copy| storage pools and active-data pools during
server data-migration processes.| The simultaneous-write function
during migration can reduce the amount of time| required to back up
storage pools or copy active data. Data that is simultaneously|
written to copy storage pools or active-data pools during migration
is not copied| again to the copy storage pools or active-data
pools. For example, suppose that| you migrate all the data in your
primary random-access disk storage pool nightly| and then back up
your primary storage pools. By using the simultaneous-write|
function during migration, you can significantly reduce the amount
of time| required for backup operations.| You can also use the
simultaneous-write function during migration if you have| many
client nodes and the number of mount points that are required to
perform| the simultaneous-write function during client store
operations is unacceptable. If| mounting and demounting tapes when
writing data simultaneously during client| store operations is
taking too much time, consider writing data simultaneously| during
migration. xx IBM Tivoli Storage Manager for Windows:
Administrators Reference
- 22. Client-side data deduplication: Changes for V6.2| With
Tivoli Storage Manager V6.2, you can specify the simultaneous-write
function| for a primary storage pool if it is the target for any of
the eligible operations (client| store sessions, server import
processes, and server data-migration processes).| Related
reference| DEFINE STGPOOL (Define a primary storage pool assigned
to random access| devices) on page 298| Use this command to define
a primary storage pool assigned to a random-access| device.| UPDATE
STGPOOL (Update a primary random access storage pool) on page|
1137| Use this command to update the definition of a storage pool
assigned to a| random-access device.| DEFINE STGPOOL (Define a
primary storage pool assigned to sequential access| devices) on
page 307| Use this command to define a storage pool defined to a
sequential-access storage| device.| UPDATE STGPOOL (Update a
primary sequential access pool) on page 1146| Use this command to
update the definition of a storage pool assigned to|
sequential-access storage device.| In-flight data encryption using
SSL| Support for Secure Sockets Layer (SSL) is available on HP-UX,
Linux, Solaris,| AIX, and Windows platforms.| With SSL
industry-standard communications, you can encrypt all traffic
between| the backup-archive client, the administrative command-line
clients, and the IBM| Tivoli Storage Manager server. You can use
either self-signed or vendor-acquired| SSL certificates. New for
the Tivoli Storage Manager reporting and monitoring feature in
version 6.2 The Tivoli Storage Manager reporting and monitoring
feature, Version 6.2 has a few new changes. The Tivoli Storage
Manager reporting and monitoring feature, Version 6.2, has been
integrated into a new user interface called the Tivoli Integrated
Portal. This move affects the reporting and monitoring reports that
are run from the Administration Center. The Administration Center
moved from the Integrated Solutions Console to the Tivoli
Integrated Portal. The Tivoli Integrated Portal provides all the
functions that were available in the Integrated Solutions Console,
but with a new look-and-feel. The Administration Center is
installed separately and is not included in the reporting and
monitoring installation. There is a new information roadmap for the
Tivoli Storage Manager reporting and monitoring feature on
theTivoli Storage Manager Wiki. This roadmap has detailed
information on planning, installing, configuring, customizing, and
trouble shooting.Reporting and monitoring feature information
roadmap New for IBM Tivoli Storage Manager Version 6.2 xxi
- 23. IBM Tivoli Integrated Portal and the Tivoli Storage Manager
reporting and monitoring feature updated in version 6.2| SCSI
passthru support for Windows| SCSI passthru support is available
for Windows in Tivoli Storage Manager Version| 6.2.| With this
support, you can choose to use a Windows Hardware Qualification
Lab| certified native device driver instead of the Tivoli Storage
Manager device driver to| control devices. Devices currently
controlled by the Tivoli Storage Manager device| driver can be
switched to a native driver without updating drive or device class|
definitions.| Concurrent read-and-write access to Centera volumes|
In previous versions of Tivoli Storage Manager, a client session or
server process| had to wait for a Centera volume if the volume was
in use by another session or| process. In V6.2, server read-access
and write-access to a Centera volume are| available concurrently.|
Concurrent access improves restore performance. Two or more clients
can read the| same volume at the same time. One client can also
write to the volume while it is| being read. In addition, multiple
client sessions and server processes (for example,| a client
restore operation and an export node operation) can read the same
volume| concurrently.| The following server processes can share
read access to Centera volumes:| v Exporting client node
definitions or file data to sequential media or directly to|
another server for immediate import| v Exporting all or part of
server control information and client file data (if| specified)
from the server to sequential media| v Generating a backup set for
a backup-archive client node| The following server processes cannot
share read access to Centera volumes:| v Checking for
inconsistencies between a storage pool volume and database|
information| v Deleting a storage pool volume and, optionally, the
files stored in the volume| A Centera volume can appear as the
current volume for more than one session and| as the target of
concurrent read and write operations. There are no command| changes
associated with this feature.| The Tivoli Integrated Portal GUI|
The IBM Tivoli Integrated Portal is a graphical user interface
(GUI) that is included| with Tivoli Storage Manager V6.2. The
Tivoli Integrated Portal provides all the| functions that were
available in the Integrated Solutions Console.| The Administration
Center, Tivoli Storage Manager reporting and monitoring| feature,
and other applications are integrated into this new graphical user
interface.| The Administration Center can be moved to the Tivoli
Integrated Portal if the| servers being managed are at version 5.5
or later. By deploying the Tivoli| Integrated Portal early, you can
prepare your system for an upgrade to Tivoli| Storage Manager V6.2.
Servers at versions earlier than 6.2 that are managed using| the
V6.2 Administration Center cannot use the version V6.2 features.
xxii IBM Tivoli Storage Manager for Windows: Administrators
Reference
- 24. IBM Tivoli Integrated Portal and the Tivoli Storage Manager
reporting and monitoring feature updated in version 6.2| The
Administration Center not installable on HP-UX| The Administration
Center, a Web-based interface for centrally configuring and|
managing Tivoli Storage Manager servers, cannot be installed on an
HP-UX server.| In IBM Tivoli Storage Manager Version 6.2, the
Administration Center cannot be| installed on an HP-UX server.
However, when installed on a supported server| platform, the
Administration Center can be used to manage HP-UX servers. For|
Administration Center system requirements, see the following Web
site:| http://www.ibm.com/support/docview.wss?uid=swg21410467| Sun
StorageTek T10000B drive encryption| You can now use tape device
encryption with Sun StorageTek T10000B drives.| Encryption provides
security for data on individual tapes and protects sensitive|
information that is transported off-site. When enabled, Tivoli
Storage Manager| handles encrypting and decrypting data on tapes
according to specifications set| when defining an ECARTRIDGE device
class.| Related reference| DEFINE DEVCLASS (Define an ECARTRIDGE
device class) on page 174| Use the ECARTRIDGE device class when you
are using StorageTek drive T10000B.| UPDATE DEVCLASS (Update an
ECARTRIDGE device class) on page 1032| Use the ECARTRIDGE device
class when you are using StorageTek drive T10000B.| MOVESIZETHRESH
server option| The MOVESIZETHRESH server option default and maximum
values have been| increased.| The MOVESIZETHRESH option specifies,
in megabytes, a threshold for the| amount of data moved as a batch,
within the same server transaction. When this| threshold is
reached, no more files are added to the current batch, and a new|
transaction is started after the current batch is moved. The
default value for| MOVESIZETHRESH has been increased from 2048 to
4096; and the maximum| value has also been increased from 2048 to
32768.| Related reference| MOVESIZETHRESH|