Administrator’s Reference
Administrator’s Reference
″Notices″ appendix.
Edition notice
This edition applies to Version
5.5 of the IBM Tivoli
Storage Manager for AIX (program
numbers 5608-HSM,
5608-ISM, 5608-ISX, 5608-SAN, 5608-ARM)
and to any subsequent releases
until otherwise indicated in new
editions
or technical newsletters.
US Government Users Restricted Rights
– Use, duplication or disclosure
restricted by GSA ADP Schedule
Contract
with IBM
Tivoli Storage
Conventions used in this guide
. . . . . . . xvii
Accessibility features . . . .
. . . . . . . xvii
Technical changes for Version 5.5. . . xix
Chapter 1. Administering the server from the command line . . . . .
. . . 1 Issuing commands from the
administrative client . . 1
Starting and stopping the
administrative client . . 2 Monitoring
server activities from the
administrative client . . . .
. . . . . . . 2
Monitoring
administrative client . . . .
. . . . . . . 3
Formatting output from commands . .
. . . . 4
Saving command output to a
specified location . . 4 Administrative
client options . . . . .
. . . 5
Issuing commands from the
Administration Center . 7 Issuing
commands
from
the
server
console
. 11
Naming Tivoli Storage Manager objects
. . . . 12 Using wildcard
characters to specify object
names . . . . . .
. . . . . . . .
. 12
Server command processing . .
. . . . . . 14 Cancelling
commands
Routing commands to a server
group . . . . . 16 Routing
commands to server groups . .
. . . 17
Routing commands to two servers
and a server
group . . . . . .
. . . . . . . .
. 17 Routing commands inside
scripts . . . . . .
17
Privilege classes for commands .
. . . . . . . 18
Commands requiring system privilege .
. . . 18
Commands requiring
Commands any administrator can issue .
. . . 23
Chapter 2. Administrative commands 25 ACCEPT commands .
. . . . . . . .
. . 26
ACCEPT DATE (Accepts the current
system date) 27
ACTIVATE commands . . . . .
. . . . . . 29
management class) . . . . .
. . . . . . 33
AUDIT commands . . . . .
. . . . . . . 35
AUDIT LIBRARY (Audit volume
inventories in
an automated library) . . . .
. . . . . . 36 AUDIT
LICENSES (Audit server storage
usage) 38
AUDIT VOLUME (Verify database
information
for a
BACKUP DEVCONFIG (Create backup
copies of device configuration
information) . . . . . . 49
BACKUP NODE (Back up a NAS
node) . . . . 51
BACKUP STGPOOL (Back up primary
storage
pool to copy storage pool) .
. . . . . . . 55 BACKUP
VOLHISTORY (Save sequential
volume
history information)
process) . . . . . . .
. . . . . . .
65
operation) . . . . . .
. . . . . . . .
66
process) . . . . . . .
. . . . . . .
67
CANCEL REQUEST
sessions) . . . . . . .
. . . . . . .
71
CHECKOUT commands . . . .
. . . . . . 81
COMMIT (Control committing of
commands in a
macro) . . . . . .
. . . . . . . .
. . 91 CONVERT commands . . .
. . . . . . . .
93
CONVERT ARCHIVE (Allow clients to
query
archive files by description) .
. . . . . . . 94
COPY
commands
from a primary storage pool
to an active-data
pool) . . . . . .
. . . . . . . .
. 97
COPY DOMAIN (Copy a policy
domain) . . . 102
COPY MGMTCLASS
COPY SCHEDULE (Copy a client
or an
administrative command schedule) . .
. . . 110 COPY SCRIPT (Copy a
Tivoli Storage Manager
script) . . . . . . .
. . . . . . . .
114
DEFINE commands . . . .
. . . . . . . 116
DEFINE
option set) . . . . .
. . . . . . . .
130
name) . . . . . . .
. . . . . . . .
134
group) .
DEFINE DBBACKUPTRIGGER (Define the
database backup trigger) . . .
. . . . . 152 DEFINE
DBCOPY (Define a volume copy
of a
database volume) . . . . .
. . . . . . 154
DEFINE EVENTSERVER (Define a server
as the
event server) . . . . .
. . . . . . .
240
server group) . . . . .
. . . . . . .
241
information) . . . . . . . .
. . . . . 256
DEFINE MACHNODEASSOCIATION
DEFINE MGMTCLASS
DEFINE POLICYSET (Define a policy
set) . . . 272
DEFINE PROFASSOCIATION (Define a
profile
association) . . . . .
. . . . . . . .
274
DEFINE RECMEDMACHASSOCIATION
DEFINE RECOVERYMEDIA
Manager script) . . . .
. . . . . . .
308
server-to-server communications) . .
. . . . 311
group) . . . . . . . . . .
. . . . . 316 DEFINE
subscription) . . . . . . .
. . . . . 360 DEFINE
VIRTUALFSMAPPING (Define a
virtual file space mapping) . .
. . . . . . 362
DEFINE VOLUME (Define a volume
in a
storage pool) . . . .
. . . . . . . .
364
option set) . . . . .
. . . . . . . .
379
DELETE COLLOCGROUP (Delete a
collocation
group) . . . . . . . . . .
. . . . . 381 DELETE
COLLOCMEMBER (Delete collocation
group member)
DELETE DOMAIN (Delete a policy
domain) 391
DELETE DRIVE (Delete a drive
from a library) 392
DELETE EVENT
DELETE FILESPACE (Delete client node
data
from the server) . . .
. . . . . . . . 396 DELETE
GRPMEMBER (Delete a server from
a
server group) . . . .
. . . . . . . .
400
DELETE LIBRARY
iv IBM Tivoli
class) . . . . . .
. . . . . . . .
. 406
DELETE NODEGROUPMEMBER (Delete node
DELETE RECMEDMACHASSOCIATION
association) . . . . . .
. . . . . . .
418
DELETE SERVERGROUP (Delete a
server
group) . . . . . .
. . . . . . . .
. 425
or recovery log space triggers) .
. . . . . . 426
DELETE STGPOOL
virtual file space mapping) . .
. . . . . . 432
DELETE VOLHISTORY (Delete sequential
volume history information) . .
. . . . . 433
volume)
node access to the server) .
. . . . . . .
446
DISMOUNT command . . . .
. . . . . . 448 DISMOUNT
VOLUME (Dismount a volume
by
volume name) . . . . .
. . . . . . .
449
DISPLAY commands . . . . .
. . . . . . 450
events for logging) . . . .
. . . . . . 453
the server) . . . . . .
. . . . . . .
456
END commands . . . . .
. . . . . . .
458
ESTIMATE DBREORGSTATS
information) . . . . . .
. . . . . . .
468
information) . . . . . .
. . . . . . .
474
EXTEND commands . . . . .
. . . . . . 513
database)
set of a client’s data) .
. . . . . . . . .
519
GENERATE BACKUPSETTOC (Generate a
table
of contents for a backup
set) . . . . . . .
527
GRANT commands . . . . .
. . . . . . 530
to a client node) . . .
. . . . . . . . 535 HALT
(Shut down the server) . .
. . . . . . 537
HELP (Get help on commands and
error messages) 539
IMPORT commands . . . . .
. . . . . . 542
information) .
instructions) . . . . . .
. . . . . . . 561
ISSUE MESSAGE (Issue a message
from a server
script) . . . . . .
. . . . . . . .
. . 563
LOCK NODE (Lock out a client
node) . . . . 574
LOCK PROFILE (Lock a profile)
. . . . . . 575 MACRO (Invoke
a macro) . . . . . . . . .
577
MIGRATE STGPOOL (Migrate storage pool
to next
storage pool) . . . . . . .
. . . . . . 579
MOVE commands . . . .
. . . . . . . .
582
volume)
member) . . . . . .
. . . . . . . .
601
pool media) . . . . .
. . . . . . . .
602
sequential access storage pool) .
. . . . . 610
NOTIFY commands
PING command . . . . .
. . . . . . . 623
servers) . . . . . .
. . . . . . . . 624
PREPARE (Create a recovery plan
file) . . . . . 625
QUERY commands . . . . .
. . . . . . 631
QUERY ACTLOG (Query the activity
log) . . . 633 QUERY ADMIN
(Display administrator
information) .
QUERY BACKUPSETCONTENTS (Query
QUERY CLOPTSET (Query a client
option set) 656
QUERY COLLOCGROUP
storage pool volume) . . . .
. . . . . . 660 QUERY
COPYGROUP (Query copy groups) . .
667 QUERY DATAMOVER (Display data
mover
definitions) . . . . .
. . . . . . . . 672
QUERY DB (Display information on
the
database) . . . . . .
. . . . . . . .
675
one or more device classes) . .
. . . . . . 684
QUERY DIRSPACE (Query storage
utilization of FILE directories) .
. . . . . . . .
. . 688
QUERY DOMAIN (Query a policy
domain) . . 689
QUERY DRIVE (Query information about
a
drive) .
manager system parameters) . .
. . . . . 705 QUERY ENABLED
(Query enabled events) . . 708
QUERY EVENT (Query scheduled
and
completed events) . . . . .
. . . . . . 710
or client events) . . .
. . . . . . . .
722
spaces) . . . . . .
. . . . . . . . 732
QUERY LIBRARY (Query a library)
. . . . . 738
QUERY LIBVOLUME (Query a library
volume) 741
QUERY LICENSE (Display license
information) 744
QUERY LOG
storage pool media) . . . .
. . . . . . 755
class) . . . . . . .
. . . . . . . .
762
images)
QUERY OCCUPANCY (Query client file
spaces
in storage pools) . . .
. . . . . . . .
782
QUERY PATH (Display a path
definition) . . . 788
QUERY POLICYSET (Query a policy
set) . . . 792
QUERY PROCESS
QUERY RECOVERYMEDIA (Query recovery
mount requests) . . . . .
. . . . . . 805
sessions)
information stored on a target
server) . . . . 811
QUERY SAN (Query the devices on
the SAN) 814
QUERY SCHEDULE (Query schedules) . .
. . 817
QUERY SCRIPT (Query Tivoli Storage
Manager
scripts) . . . . . .
. . . . . . . .
825
QUERY SERVER
triggers) . . . . . .
. . . . . . . .
840
value) . . . . . . .
. . . . . . . .
843
QUERY STGPOOL
configuration and capacity) . . .
. . . . . 864
QUERY TOC (Display table of
contents for a
backup image)
volumes) . . . . . .
. . . . . . . .
880
administrative client) . . . .
. . . . . . .
887
RECLAIM commands . . . . .
. . . . . 888
REDUCE DB (Decrease the assigned
capacity of the database) . .
. . . . . . . .
. . 897
REDUCE LOG (Decrease the assigned
capacity
of the recovery log) . .
. . . . . . . . 898
REGISTER commands . . . .
. . . . . . 900
REGISTER ADMIN (Register an
administrator) 901
REGISTER LICENSE
RENAME ADMIN (Rename an
administrator) 920
RENAME FILESPACE (Rename a client
file
space on the server) . . .
. . . . . . .
921
RENAME NODE
storage pool) . . . . .
. . . . . . .
927
RESET commands . . . . .
. . . . . . .
929
pool statistics)
RESET LOGMAXUTILIZATION (Reset the
operation)
RESTORE VOLUME (Restore primary
volume
data from a copy pool or
an active-data pool) . 947
REVOKE commands . . . . .
. . . . . .
952
SELECT (Perform an SQL query
of the IBM Tivoli
Storage Manager Database) . . .
. . . . . . 962
performance . . . . .
. . . . . . . .
970
command . . . . . . .
. . . . . . 971
period or the size of the
activity log) . . . .
977
SET ARCHIVERETENTIONPROTECTION
SET AUTHENTICATION (Set password
configuration refresh) . . . .
. . . . . . 985 SET
CONTEXTMESSAGING (Set message
context reporting on or off) .
. . . . . . .
987
SET CROSSDEFINE
SET DRMCMDFILENAME (Specify the name
of a file to contain
commands) . . . . . .
. 990
SET DRMCOPYSTGPOOL (Specify the
copy
storage pools to be managed
by DRM) . . . .
991
SET DRMCOURIERNAME (Specify the
courier
name) . . . . . .
. . . . . . . .
. 992
SET DRMDBBACKUPEXPIREDAYS
recovery instructions file names) .
. . . . . 996
SET DRMNOTMOUNTABLENAME (Specify the
not mountable location name) .
. . . . . . 998 SET
DRMPLANPREFIX (Specify a prefix
for
recovery plan
SET DRMRPFEXPIREDAYS (Set criteria
for
recovery plan file expiration) . .
. . . . . 1004
SET DRMVAULTNAME (Specify the
vault
name) . . . . . .
. . . . . . . .
1006
period for
period) . . . . . .
. . . . . . . .
1010
log records) . . . . .
. . . . . . . 1011
SET MAXSCHEDSESSIONS (Set maximum
length)
SET REGISTRATION (Set open or
closed
registration) . . . . .
. . . . . . .
1021
attempts) . . . . . .
. . . . . . .
1023
SET SCHEDMODES
SET SERVERNAME (Specify the server
name) 1028
SET SERVERPASSWORD (Set password
for
server) . . . . . .
. . . . . . . .
1030
SET SQLDATETIMEFORMAT
arithmetic) . . . . .
. . . . . . . .
1034
nodes) . . . . . .
. . . . . . . .
1035
SET TAPEALERTMSG
SETOPT (Set a server option
for dynamic update) 1039
SHRED commands . . . .
. . . . . . .
1040
running export operation) . . .
. . . . . .
1043
UNLOCK NODE (Unlock a client
node) . . . 1049
UNLOCK PROFILE (Unlock a
profile) . . . . 1050 UPDATE
commands . . . . . .
. . . . 1051
UPDATE ADMIN (Update an
administrator) 1052
UPDATE ARCHIVE (Manage archive
usage
and performance)
set description) . . . . .
. . . . . .
1062
UPDATE DATAMOVER (Update a
data
mover) . . . . . .
. . . . . . . .
1073
UPDATE DBBACKUPTRIGGER
UPDATE DRIVE (Update a drive) .
. . . . 1145
UPDATE LIBRARY (Update a library) .
. . . 1149
UPDATE LIBVOLUME (Change the status
of a
storage volume) . . . .
. . . . . . .
1155
UPDATE NODE (Update node
attributes) . . 1162 UPDATE NODEGROUP
(Update a node
group) . . . . . . .
. . . . . . . 1170
UPDATE PATH (Change a path) . .
. . . 1171
UPDATE POLICYSET (Update a policy
set
description) . . . . .
. . . . . . .
1177
description)
Manager script) . . . .
. . . . . . . 1203
server-to-server communications) . . .
. . 1205
group description)
UPDATE VOLHISTORY (Update sequential
volume history information) . . .
. . . . 1250
volume) . . . . . .
. . . . . . . . 1252
VALIDATE commands
VARY (Bring a random access
volume online or
offline) . . . . . . .
. . . . . . . .
1262
Types of server options . .
. . . . . . . .
1265
Communication options
Database and recovery log options .
. . . . 1267 Data transfer
options . . . . . . . . .
1268
Message options . . . .
. . . . . . . 1268
viii IBM Tivoli
About this publication
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 guide
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.
Tivoli Storage Manager publications
and other related publications are
available
online.
You can search all the Tivoli
Storage Manager publications in the
Information
Center:
http://publib.boulder.ibm.com/infocenter/tivihelp/v1r1/index.jsp
You can download PDF versions
of publications from the IBM
Publications Center:
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/
pbi.cgi
You can also order some related
publications from this 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.
Publication Title Order Number
IBM
Tivoli
Storage
Manager
Problem
Determination
IBM Tivoli Storage Manager
for AIX Administrator’s
Guide SC32-0117
IBM
Tivoli
Storage
Manager
for
AIX
Publication Title Order Number
IBM Tivoli Storage Manager
for HP-UX Administrator’s
Guide SC32-0118
IBM Tivoli Storage Manager
for HP-UX Administrator’s
Reference SC32-0124
IBM
Tivoli
Storage
Manager
for
Linux
Installation
Guide
GC23-5971
IBM Tivoli Storage Manager
for Linux Administrator’s Guide
SC32-0119
IBM Tivoli Storage Manager
for Linux Administrator’s
Reference SC32-0125
IBM
Tivoli
Storage
Manager
for
Sun
Solaris
Installation
Guide
GC23-5972
IBM Tivoli Storage Manager
for Sun Solaris Administrator’s
Guide SC32-0120
IBM
Tivoli
Storage
Manager
for
Sun
Solaris
IBM Tivoli Storage Manager
for Windows Administrator’s
Guide SC32-0121
IBM
Tivoli
Storage
Manager
for
Windows
IBM Tivoli Storage Manager
for z/OS Administrator’s Guide
SC32-0122
IBM
Tivoli
Storage
Manager
for
IBM Tivoli Storage Manager
for System Backup and Recovery
Installation
and User’s Guide
Publication Title Order Number
Guide
SC32-0129
IBM Tivoli Storage Manager
for SAN for
HP-UX Storage Agent
User’s
Guide
SC32-0130
IBM
Tivoli
Storage
Manager
for
SAN
for
Linux
Storage
Agent
Guide
SC32-0131
IBM Tivoli Storage Manager
for SAN for Sun
Solaris Storage Agent
User’s Guide
Publication Title Order Number
Installation and User’s Guide
SC32-0143
IBM
Tivoli
Storage
Manager
for
NetWare:
Backup-Archive
Clients
Installation
and
Clients Installation and User’s
Guide
SC32-0145
IBM
Tivoli
Storage
Manager
for
Windows:
Backup-Archive
Clients
Installation
and
Guide
SC32-0146
IBM Tivoli Storage Manager
for Space Management for
UNIX and Linux:
User’s Guide
Publication Title Order Number
Publication Title
Guide
for
Oracle
SC33-8207
IBM Tivoli Storage Manager
for Advanced Copy Services:
Data Protection for
Snapshot Devices for DB2
Installation and User’s Guide
SC33-8330
IBM
Tivoli
Storage
Manager
for
Advanced
Copy
Services:
Data
Protection
for
WebSphere
Application
Server
Installation
and
IBM Tivoli Storage Manager
for Databases: Data Protection
for Informix
Installation and User’s Guide
SH26-4095
IBM
Tivoli
Storage
Manager
for
Databases:
Data
Protection
for
Microsoft
SQL
Server
Installation
and
Guide
SC32-9059
IBM Tivoli Storage Manager
for Databases: Data Protection
for Oracle for UNIX
and Linux Installation and User’s
Guide
SC32-9064
IBM
Tivoli
Storage
Manager
for
Databases:
Data
Protection
for
Oracle
for
Windows
Installation
and
Guide
SC32-9065
IBM Tivoli Storage Manager
for Enterprise Resource Planning:
Data Protection for
SAP Installation and User’s Guide
for DB2
SC33-6341
IBM
Tivoli
Storage
Manager
for
Enterprise
Resource
Planning:
Data
Protection
for
SAP
Installation
and
Guide
for
Oracle
SC33-6340
IBM Tivoli Storage Manager
for Hardware: Data Protection
for Enterprise Storage
Server® for DB2 UDB Installation
and User’s Guide
SC32-9060
IBM
Tivoli
Storage
Manager
for
Hardware:
Data
Protection
for
Snapshot
Devices
for
Oracle
Installation
and
Guide
GC32-1772
IBM Tivoli Storage Manager
for Mail: Data Protection
for Lotus Domino for
UNIX, Linux, and OS/400® Installation
and User’s Guide
SC32-9056
IBM
Tivoli
Storage
Manager
for
Mail:
Data
Protection
for
Lotus
Domino
for
Windows
Installation
and
Guide
SC32-9057
IBM Tivoli Storage Manager
for Mail: Data Protection
for Microsoft Exchange
Server Installation and User’s
Guide
SC32-9058
Related hardware publications
Put your short description here; used
for first paragraph and
abstract.
Title Order Number
IBM Magstar 3494 Tape Library
Introduction and Planning Guide
GA32-0279
IBM
3490E
Model
E01
and
E11
IBM Magstar MP 3570 Tape
Subsystem Operator’s Guide GA32-0345
IBM TotalStorage Tape Device Drivers
Installation and User’s Guide
GC35-0154
IBM
TotalStorage
Enterprise
Tape
System
3590
Operator
Guide
GA32-0330
IBM
TotalStorage
Enterprise
Tape
System
3592
Operator
Support information
You can find support information
for IBM products from a number
of different
sources:
Getting technical training
http://www.ibm.com/software/tivoli/education/
Searching knowledge bases
If you have a problem with
Tivoli Storage Manager, there is
a variety of knowledge
bases you can search.
You can begin with the
Information Center, from which you
can search all the
Tivoli Storage Manager publications:
http://publib.boulder.ibm.com/infocenter/
tivihelp/v1r1/index.jsp
Searching the Internet If you cannot find
an answer to your question in
the 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:
http://www.ibm.com/software/sysmgmt/products/support/
IBMTivoliStorageManager.html. From this
section, 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 your problem, you
can search forums and
newsgroups on the Internet for
the latest information that might
help you resolve
your problem.
Using IBM Support Assistant The IBM Support
Assistant is a free, stand-alone
application that you can install
on
any workstation. You can then
enhance the application by
installing
product-specific plug-in modules for
the IBM products 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:
For more information, see the
IBM Support Assistant Web site
at
http://www.ibm.com/software/support/isa/
Finding product fixes A product fix might
be available to resolve your
problem. You can determine what
fixes are available by checking
the product support Web site.
1. Go to the IBM Software
Support Web site: http://www.ibm.com/software/
tivoli/products/storage-mgr/product-links.html
2. Click the
Pages link for your Tivoli
Storage Manager product.
3. Click Fixes for a list
of fixes for your
product.
4. Click the name of a
fix to read the description and
optionally download the fix.
Getting E-mail notification of product fixes You can
sign up to receive weekly
E-mail notifications about fixes and
other news
about IBM products.
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.
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
Before you contact IBM Software
Support, you must have an
active IBM software
maintenance contract, and you must
be authorized to submit
problems to IBM. The
type of software maintenance
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 DB2® and WebSphere® products
that
run on Windows® or UNIX® operating
systems), enroll in Passport
Advantage®
in one of the following
ways:
Online Go to the Passport Advantage
Web page (http://www.ibm.com/
software/sw-lotus/services/cwepassport.nsf/wdocs/passporthome)
and
click How to Enroll
By
phone
For the phone number to call
in your country, go to the
IBM Contacts
Web page
(http://techsupport.services.ibm.com/guides/contacts.html)
and click the name of
your geographic region.
v For IBM eServer™ software
products (including, but not
limited to, DB2 and
WebSphere products that run in
zSeries®, pSeries®, and iSeries™
environments),
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 eServer software
products, go to the IBM
Technical Support
Advantage Web page:
http://www.ibm.com/servers/eserver/techsupport.html.
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 IBM Contacts
Web page,
http://techsupport.services.ibm.com/guides/contacts.html,
and click
the name of your geographic
region.
Perform these actions to contact
IBM Software Support:
1. Determine the business
impact of your problem.
2. Describe your problem and
gather background information.
3. Submit your problem to IBM
Software Support.
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.
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
Describe your problem and gather background information When
explaining a problem to IBM,
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
re-created? 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.
Submit your problem to IBM Software Support You can
submit your problem to IBM
Software Support online or by
phone.
Online
Go to the ″Submit and track
problems″ page on the IBM Software
Support
site http://www.ibm.com/software/support/probsub.html
. Enter your
By phone
For the phone number to call
in your country, go to the
contacts page of the IBM
Software Support Handbook on the
Web and click the name of
your geographic region.
If the problem 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. Whenever
possible,
IBM Software Support provides a
workaround for you to implement
until the
APAR is resolved and a fix is
delivered. IBM publishes resolved
APARs on the
IBM product support Web pages daily,
so that other users who
experience the
same problem can benefit from
the same resolutions.
Conventions used in this guide
v Command to be entered
on the AIX® command line:
> dsmadmc
v Command to be entered
on the command line of an
administrative client:
query devclass
In the usage and descriptions
for administrative commands, the term
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.
Accessibility features
Accessibility features help a user
who has a physical disability,
such as restricted
mobility or limited vision, to
use software products successfully.
The major
accessibility features of Tivoli
Storage Manager are described in
this topic.
v Server and client command-line
interfaces provide comprehensive control
of Tivoli Storage Manager
using a keyboard.
v The Windows client-graphical
interface can be navigated and
operated using a
keyboard.
v The Web backup-archive
client interface is HTML 4.0
compliant, and accessibility
is limited only by the
choice of Internet
browser.
v All user documentation is
provided in HTML and PDF
format. Descriptive text
is provided for all documentation
images.
v The Tivoli Storage Manager
for Windows Console follows
Microsoft®
conventions for all keyboard
navigation and access. Drag and
Drop support is
handled using the Microsoft Windows
Accessibility option known as
MouseKeys. For more information
about MouseKeys and other
Windows
accessibility options, please refer
to the Windows Online Help
(keyword:
MouseKeys).
Technical changes for Version
5.5
The following changes have been
made to the product for this
edition:
New method for calculating migration
thresholds for storage pools
associated
with sequential-access disk (FILE)
devices
In previous releases of Tivoli
Storage Manager, migration thresholds for
storage pools associated with
sequential-access disk (FILE) devices were
based on the percentage
of volumes utilized. In this
release, migration
thresholds are based on a
percentage of the storage
pool’s total data
capacity. Migration thresholds for
other types of sequential-access
storage
pools are still based on
the percentage of volumes
utilized.
For example, a sequential-access disk
storage pool with a total
capacity of 100 TB and a
high migration threshold of 70%
will be migrated when the
pool contains 70 TB of
data. This method of
calculating migration
thresholds provides a potentially
more efficient use of
large,
sequential-access disk storage pools.
The server continues to migrate
files
by volume; after each volume is
migrated, the server checks to
determine
if the low migration threshold
has been reached.
When you start the version 5.5
server, the percentage of data
in a
FILE-type storage pool that can
be migrated is immediately
recalculated
using the new metric. If
you are upgrading from a
previous version of Tivoli
Storage Manager, you will discover
that more data must be
stored
before migration starts. Be sure
to adjust your migration
thresholds so that
you do not run out of
space for routine storage operations
such as client
backups.
v DEFINE STGPOOL—Primary Sequential
Access
v UPDATE STGPOOL—Primary Sequential
Access
Concurrent access to volumes in
storage pools with a device
type of FILE
In previous versions of Tivoli
Storage Manager, a client session
or server
process had to wait for a
FILE volume if the volume
was in use by another
session or process. In this
version, the Tivoli Storage Manager
server
allows concurrent read access and
write access to the volume.
Concurrent access improves restore
performance by allowing two or
more
clients to access the same
volume at the same time.
Multiple client sessions
(archive, retrieve, backup, and
restore) or server processes (for
example,
storage pool backup) can read
the volume concurrently. In addition,
one
client session can write to the
volume while it is being
read.
The following server processes are
allowed shared read access to
FILE
volumes:
v RESTORE VOLUME
The following server processes are
not allowed shared read access
to FILE
volumes:
v RECLAMATION
A FILE 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.
Restartable server-to-server export
You can now suspend and later
restart an export operation if
it is a
server-to-server export that is
designated with a FILEDATA value
other
than NONE. If an export
operation was suspended because
of errors or
because the SUSPEND EXPORT
command was issued, you can
restart the
export at the point where it
was suspended. To find those
export
operations that can be
restarted, issue the QUERY EXPORT
command.
You can also specify the
TODATE/TOTIME parameter when issuing
an
EXPORT NODE or EXPORT SERVER
command. The following commands
were added to support restartable
exports:
v CANCEL EXPORT
v QUERY EXPORT
v RESTART EXPORT
v SUSPEND EXPORT
IBM and HP LTO-4 Drive Support and Encryption Tivoli
Storage Manager now supports IBM
and HP LTO-4 tape drives.
New
recording formats are available for
the LTO device class. Tape
device
encryption is also supported.
Encryption provides security for data
on
individual tapes and protects
sensitive information that might
be
transported off-site. When enabled, Tivoli
Storage Manager handles
encrypting and decrypting data on
tapes, according to specifications
set
when defining the LTO device
class. To enable drive encryption
with IBM
LTO-4, you must have the IBM
RMSS Ultrium device driver installed.
SCSI
drives do not support IBM LTO-4
encryption.
For details about encryption, see
the Administrator’s Guide.
See the following changed
commands:
v DEFINE DEVCLASS—LTO
v UPDATE DEVCLASS—LTO
New support for Plasmon and IBM
UDO2 optical disk drives and
media
Tivoli Storage Manager now supports
Plasmon and IBM UDO2 optical
disk
drives and media. A new
recording format is available for
the OPTICAL
device type. You cannot mix
UDO1 and UDO2 drives in a
single library.
See the following changed
commands:
v DEFINE DEVCLASS—Optical and WORM
types
v UPDATE DEVCLASS—Optical and WORM
types
Support for long file names
Tivoli Storage Manager now supports
up to 8704 bytes in
length for fully
qualified file names (a file
name and file path combined).
This support is
available for backup and restore
functions, and is dependent on
whether or
not the client also supports
the byte length. Fully
qualified file names
might be truncated in message
or query output. To display the
full name,
use the DISPLAY OBJNAME
command.
See the following new command:
v DISPLAY OBJNAME
TCP/IP Version 6
Tivoli Storage Manager is now
able to use TCP/IP Version 6
(IPv6) as its
communications protocol. IPv6 is
interoperable with TCP/IP Version 4.
You
can specify either IPv4 or
both IPv4 and IPv6 in
the COMMMETHOD
option when you start the
server, storage agent, client, or
API application.
The same port numbers are used
by the server, storage agent,
client, or API
application for both IPv4 and
IPv6.
IPv6 address formats are acceptable
for all functions that support
IPv6.
However, if you use IPv6
addresses for functions that do
not support IPv6,
communications will fail. The
following functions do not support
IPv6:
v NDMP: backing up and
restoring storage pools, copying and
moving
data (continue to use IPv4)
v ACLS (continue to use
IPv4)
v SNMP (continue to use
IPv4)
v Centera device support (continue
to use IPv4)
v Shared Memory Protocol (continue
to use IPv4)
v Windows Microsoft Management
Console functions (continue to
use
IPv4)
v Administration Center (continue to
use IPv4)
See the following changed server
option:
v “COMMMETHOD” on page 1282
Client and Server authentication
using Secure Socket Layer (SSL)
Tivoli Storage Manager now supports
the use of Secure Socket
Layer (SSL)
for authentication of passwords
between the server and
clients.
See the following new command:
DELETE KEYRING
See the following new server
options:
v “SSLTCPPORT” on page 1330
v “SSLTCPADMINPORT” on page 1329
Running SAN Discovery for non-root
users
You can run SAN discovery to
obtain information about devices on
a
storage area network for LAN-free
configuration or to automatically
correct
device special file names if
they have changed. SAN discovery
on AIX
requires root user authority. To
allow both root and non-root
users to
perform SAN discovery, a special
utility module, dsmqsan, is
invoked
when a SAN-discovery function is
launched. The module performs as
root,
giving SAN-discovery authority to
non-root users. The dsmqsan
module
Technical changes
works only for SAN-discovery
functions, and does not provide
root
privileges for any other Tivoli
Storage Manager functions.
See the Administrator’s Guide
for more information.
Tivoli Storage Manager provides
several different command line
interfaces. The
interface you choose depends on
the tasks that you want to
perform and
accessibility.
v Administrative command-line client
v Administration Center command line
The administrative command-line client is
a program that runs on
a file server,
workstation, or mainframe. It is
installed as part of the Tivoli
Storage Manager
server installation process. With the
administrative client, you can issue
any and all
server commands.
Compared to the administrative
client, the capabilities of the
server console are
somewhat limited. For example, you
cannot issue certain commands from
the
server console, and you cannot
specify that certain commands process
before other
commands can be issued. (This
procedure can be useful if,
for example, you want
to run two commands in quick
succession.) Furthermore, because the
server
console is a DOS window on
the machine on which the server
is installed, you
must be physically located at
the server machine to use the
console. The
administrative client, on the other
hand, can be accessed remotely
from a different
location. You cannot route commands
to other servers from the
server console.
The Administration Center is a
Web-based, task-oriented interface for
centrally
configuring and managing Tivoli
Storage Manager servers. The
Administration
Center provides a command line
interface that you can use
if necessary. For
example, you might want to use
the command line interface to
perform Tivoli
Storage Manager functions that are
limited or not supported in the
Administration
Center. Using the command line
in the Administration Center, you
can issue any
and all server commands.
Issuing commands from the
administrative client
The administrative command-line client is
a program that runs on
a file server,
workstation, or mainframe.
Ensure that your administrative
client and your server are
running in compatible
languages. See “LANGUAGE” on page
1297 for language and locale
options. If your client and
server are using different languages,
the messages that Tivoli
Storage Manager generates might not
be understandable.
“Administrative client options” on
page 5 In all administrative client
modes, you can use options to
modify
administrative client session
responses.
“Saving command output to a
specified location” on page 4 The
most common use for redirecting
output is to save the output
from query
Use the DSMADMC command to
start an administrative client
session.
The Tivoli Storage Manager server
must be running before an
administrative client
can connect. For instructions about
starting the server, see the
Installation Guide.
To start an administrative client
session in command-line mode, enter
this
command on your workstation:
Note:
1. If you do not want
to be prompted for a user
ID and password, enter the
DSMADMC command using the -ID
and -PASSWORD options as shown.
2. The -DATAONLY option specifies
whether product version information
and output headers display with
the output. The default is
NO.
v NO specifies that the product
version information and output
column
headers display.
v YES suppresses the product
version information and output
column
headers.
Stop an administrative command-line
client session by entering the
following
command on your workstation:
quit
“Administrative client options” on
page 5 In all administrative client
modes, you can use options to
modify
administrative client session responses.
Monitoring server activities from the
administrative client
To monitor Tivoli Storage Manager
activities, such as server migration
and client
logons, run the administrative client in
console mode. You cannot enter
any
administrative commands in console
mode.
To start an administrative client
session in console mode,
enter:
dsmadmc -consolemode
You are prompted for a password
if authentication is turned on
for the server. If you do
not want to be prompted
for your user ID and password,
enter the
DSMADMC command with the -ID
and -PASSWORD options.
To end an administrative client
session in console mode, see Table
1.
Table 1.
Windows
client
To monitor the mounting and
dismounting of removable media, run
the
administrative client in mount mode.
When the client is running in
mount mode,
you cannot enter any administrative
commands.
To start an administrative client
session in mount mode, enter:
dsmadmc -mountmode
You are prompted for a password
if authentication is turned on
for the server. If you
do not want to be
prompted for your user ID and
password, enter the
DSMADMC command with the -ID
and -PASSWORD options.
To end an administrative client
session in mount mode, see Table
1 on page 2.
Processing commands one at a time
from the administrative
client
Use batch mode to enter a
single administrative command. Your
administrative
client session automatically ends
when the command has processed.
To start an administrative client
session in batch mode,
enter:
dsmadmc server_command
If you do not want to
be prompted for your user
ID and password, you can
enter
the DSMADMC command with the
-ID and -PASSWORD options.
In batch mode, you must
enter the complete command on
one line. If a command
does not fit on one line,
enter the command by using
a macro or a script. If
you
specify a parameter with a string of text using batch
mode, enclose the text in single quotation marks
(’ ’) in the macro. Do
not use double quotes for
commands
in batch mode, because
your operating system might not
parse the quotes correctly.
Processing a series of commands from
the administrative
client
Use the interactive mode to
process a series of
administrative commands.
To start an administrative client
session in interactive mode, a
server session must
be available. To ensure the
availability of server sessions
for both administrative
and client node sessions, the
interactive mode of the
administrative client is
disconnected if one or more
of the following conditions is
true:
v The server was stopped using
the HALT command.
v Commands were not issued from
the administrative client session
for the length
of time specified with the
IDLETIMEOUT server option.
v The administrative client session
was canceled with the CANCEL
SESSION
command.
You can use co