![]() |
![]() |
[ | | | ]
IBM(R) Tivoli(R) Storage Manager is a client-server licensed product that provides storage management services in a multi-platform computer environment. The backup-archive client program permits users to back up and archive files from their workstations or file servers to storage, and restore and retrieve backup versions and archived copies of files to their local workstations.
In addition to the backup-archive client, Tivoli Storage Manager includes the following components available on a variety of platforms:
Associated with Tivoli Storage Manager, but sold separately, is the Tivoli Space Manager client program which was previously a feature of ADSM known as Hierarchical Storage Manager (HSM). Tivoli Space Manager automatically migrates eligible files to storage to maintain specific levels of free space on local file systems and automatically recalls migrated files when they are accessed. It also permits users to migrate and recall specific files. This client program runs only on AIX, HP-UX, Linux for X86, and Solaris operating systems. For specific software requirements, see the README file that is shipped on the product installation media. See IBM Tivoli Storage Manager for Space Management for UNIX User's Guide for more information.
The terms hierarchical storage management and space management have the same meaning throughout this publication.
This manual provides instructions for an end-user to install, configure, and use the Tivoli Storage Manager client. For installation information and supported operating system levels, see Chapter 1, Installing Tivoli Storage Manager. For configuration information, see Chapter 2, Configuring Tivoli Storage Manager.
This manual assumes that you are familiar with your workstation, your operating system, and your basic system administration.
Tivoli Storage Manager tasks that can only be performed by authorized users and root users are identified by the phrases, Authorized User and root user. See Root and authorized user tasks for more information about these tasks. An Authorized User is any user running with a real user ID of 0 (root) or a user who owns the Tivoli Storage Manager executable and whose owner execution permission bit is set to s. In the following example, the user tivoli is an Authorized User while running dsmc since the dsmc owner execution permission bit is set to s:
-rwsr-xr-x 1 tivoli dsmdev 2880479 Nov 5 13:42 dsmc*
Technical support information and publications are available at the following address:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
By accessing the Tivoli Storage Manager home page, you can access subjects that interest you. You can also access current Tivoli Storage Manager product information.
The Tivoli Storage Manager home page Self help section provides customers with a knowledge base of articles and information on issues with Tivoli Storage Manager that they might be experiencing.
This book uses the following typographical conventions:
Table 1. Typographical conventions
Example | Description |
---|---|
dsmc.nlm | A series of lowercase letters with an extension indicates Tivoli Storage Manager program file names. |
archive | Boldface type indicates a command that you type at a workstation, such as a command you type on a command line. |
dateformat | Boldface italic type indicates a Tivoli Storage Manager option.
The bold type is used to introduce the option, or used in an example.
Occasionally, file names are entered in boldface italic for emphasis. |
filespec | Italicized type indicates either the name of a parameter, a new term, or
a placeholder for information that you provide.
Italics are also used for emphasis in the text. |
maxcmdretries | Monospaced type represents fragments of a program or information as it would display on a screen. |
plus sign (+) | A plus sign between two keys indicates you should press both keys at the same time. |
This section describes how to read the syntax diagrams used in this manual. To read a syntax diagram, follow the path of the line. Read from left to right, and top to bottom.
Syntax items, such as a keyword or variable, can be:
Syntax diagram description | Example |
---|---|
Abbreviations:
Uppercase letters denote the shortest acceptable truncation. If an item appears entirely in uppercase letters, it cannot be truncated. You can type the item in any combination of uppercase or lowercase letters. In this example, you can enter KEYWO, KEYWORD, or KEYWOrd. |
>>-KEYWOrd----------------------------------------------------->< |
Symbols:
Enter these symbols exactly as they appear in the syntax diagram. |
|
Variables:
Italicized lowercase items (var_name) denote variables. In this example, you can specify a var_name when you enter the KEYWORD command. |
>>-KEYWOrd--var_name------------------------------------------->< |
Repetition:
An arrow returning to the left means you can repeat the item. A character or space within the arrow means you must separate repeated items with that character or space. A footnote by the arrow references the number of times you can repeat the item. |
.--------. V | >>---repeat-+--------------------------------------------------><
.-,------. V | >>---repeat-+--------------------------------------------------><
.-------------. V (1) | >>---repeat------+---------------------------------------------><
Notes:
|
Required choices:
When two or more items are in a stack and one of them is on the line, you must specify one item. In this example, you must choose A, B, or C. |
>>-+-A-+------------------------------------------------------->< +-B-+ '-C-' |
Optional choice:
When an item is below the line, that item is optional. In the first example, you can choose A or nothing at all. When two or more items are in a stack below the line, all of them are optional. In the second example, you can choose A, B, C, or nothing at all. |
>>-+---+------------------------------------------------------->< '-A-'
>>-+---+------------------------------------------------------->< +-A-+ +-B-+ '-C-' |
Defaults:
Defaults are above the line. The default is selected unless you override it. You can override the default by including an option from the stack below the line. In this example, A is the default. You can override A by choosing B or C. You can also specify the default explicitly. |
.-A-. >>-+---+------------------------------------------------------->< +-B-+ '-C-' |
Repeatable choices:
A stack of items followed by an arrow returning to the left means you can select more than one item or, in some cases, repeat a single item. In this example, you can choose any combination of A, B, or C. |
.-------. V | >>---+-A-+-+--------------------------------------------------->< +-B-+ '-C-' |
Syntax fragments:
Some diagrams, because of their length, must fragment the syntax. The fragment name appears between vertical bars in the diagram. The expanded fragment appears between vertical bars in the diagram after a heading with the same fragment name. |
>>-| The fragment name |--------------------------------------->< The fragment name: .-A-. |--+---+--------------------------------------------------------| +-B-+ '-C-' |
Table 2 lists the IBM Tivoli Storage Manager client and server
publications that are referred to in this manual.
Table 2. IBM Tivoli Storage Manager client and server publications
Publication title | Order number |
---|---|
Client publications | |
IBM Tivoli Storage Manager Messages | GC32-0767 |
IBM Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide | GC32-0788 |
IBM Tivoli Storage Manager for NetWare Backup-Archive Clients Installation and User's Guide | GC32-0786 |
IBM Tivoli Storage Manager for Macintosh Backup-Archive Clients Installation and User's Guide | GC32-0787 |
IBM Tivoli Storage Manager for Space Management for UNIX User's Guide | GC32-0794 |
IBM Tivoli Storage Manager Using the Application Programming Interface | GC32-0793 |
IBM Tivoli Storage Manager for Application Servers 5.2: Data Protection for WebSphere Application Server Installation and User's Guide | SC32-9075 |
Server publications | |
IBM Tivoli Storage Manager for AIX Quick Start | GC32-0770 |
IBM Tivoli Storage Manager for AIX Administrator's Reference | GC32-0769 |
IBM Tivoli Storage Manager for AIX Administrator's Guide | GC32-0768 |
IBM Tivoli Storage Manager for AIX Storage Agent User's Guide | GC32-0771 |
IBM Tivoli Storage Manager for HP-UX Quick Start | GC32-0774 |
IBM Tivoli Storage Manager for HP-UX Administrator's Reference | GC32-0773 |
IBM Tivoli Storage Manager for HP-UX Storage Agent User's Guide | GC32-0727 |
IBM Tivoli Storage Manager for Linux Quick Start | GC23-4692 |
IBM Tivoli Storage Manager for Linux Administrator's Reference | GC23-4691 |
IBM Tivoli Storage Manager for Linux Storage Agent User's Guide | GC23-4693 |
IBM Tivoli Storage Manager for OS/390 and z/OS Quick Start | GC32-0777 |
IBM Tivoli Storage Manager for OS/390 and z/OS Administrator's Reference | GC32-0776 |
IBM Tivoli Storage Manager for OS/400 PASE Quick Start | GC23-4696 |
IBM Tivoli Storage Manager for Sun Solaris Quick Start | GC32-0780 |
IBM Tivoli Storage Manager for Sun Solaris Administrator's Reference | GC32-0779 |
IBM Tivoli Storage Manager for Sun Solaris Administrator's Guide | GC32-0778 |
IBM Tivoli Storage Manager for Sun Solaris Storage Agent User's Guide | GC32-0781 |
IBM Tivoli Storage Manager for Windows Quick Start | GC32-0784 |
IBM Tivoli Storage Manager for Windows Administrator's Guide | GC32-0782 |
All Tivoli publications are available for electronic download or order from the IBM Publications Center: http://www.ibm.com/shop/publications/order/.
The Tivoli Storage Manager publications are available on the following
CD-ROM:
Tivoli Storage Manager Publications Version 5.2, SK3T-8176
The format of the publications is PDF and HTML.
If you have questions or comments regarding Tivoli publications and product documentation, please visit http://www.ibm.com/software/tivoli/contact.html to send an e-mail.
The International Technical Support Center (ITSC) publishes Redbooks, which are books on specialized topics such as using Tivoli Storage Manager to back up databases. You can order publications through your IBM representative or the IBM branch office serving your locality. You can also search for and order books of interest to you at the IBM Redbooks Web site at this address:
http://www.ibm.com/redbooks/
Tivoli Field Guides are designed to address specific technical scenarios or concepts that are often complex to implement or difficult to understand. All completed field guides are available free to registered customers and internal IBM employees at the following Web site:
http://www.ibm.com/software/sysmgmt/products/support/Field_Guides.html
For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
http://www.ibm.com/ibmlink/
http://www.ibm.com/software/support/probsub.html.
Customers in the United States can also call 1-800-IBM-SERV (1-800-426-7378).
International customers should consult the Web site for customer support telephone numbers.
You can also review the IBM Software Support Guide, which is available on our Web site at http://techsupport.services.ibm.com/guides/handbook.html.
When you contact IBM Software Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information is needed to register for online support available on the Web site.
The support Web site offers extensive information, including a guide to support services (IBM Software Support Guide); frequently asked questions (FAQs); and documentation for all IBM Software products, including Release Notes, Redbooks, and white papers, defects (APARs), and solutions. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases.
We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please complete our customer feedback survey at:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
by selecting the Feedback link in the left navigation bar.
Please have the following information ready when you report a problem:
You can find client and server patches, device support, and maintenance updates for current and previous versions of Tivoli Storage Manager through the anonymous FTP server, ftp://ftp.software.ibm.com. IBM Tivoli Storage Manager information is in the /storage/tivoli-storage-management directory.
A newsgroup, listserv@marist.edu, is implemented by a third party. IBM supports this newsgroup on a best-effort basis only. See Online forum for more information.