Tivoli Storage Manager Installing the Clients


Chapter 1. Introducing the Tivoli Storage Manager

The Tivoli Storage Manager (TSM) is a client-server program that helps you protect valuable information on client workstations. Using the TSM backup-archive client, you can maintain backup versions of workstation files that can be restored quickly and easily if the original files are damaged or lost. You can also archive files that are not currently needed on a client workstation, and retrieve them when necessary.

In addition to the backup-archive client, TSM provides a Web backup-archive client (Web client) that permits an authorized administrator, help desk person, or end user to perform backup, restore, archive, and retrieve services on any machine or platform that supports a Java 1.1.6-capable browser, such as Netscape Navigator 4.06 or higher, or Microsoft Internet Explorer 4.01 or higher. You can perform multiple Web client sessions simultaneously. For example, you can perform a backup, archive, restore, and query on separate Web browsers. Do not perform such operations simultaneously on the same browser, or you may unintentionally destroy data that you need.

The Web client is available on AIX, HP-UX, Linux, NUMA-Q, OS/390 UNIX, SGI, Solaris, Tru64 UNIX, UnixWare, and OS/2 client platforms. The following functions are not supported by the Web client:

This book explains how to install the clients and perform initial setup tasks. Setup tasks include creating options files and setting options, such as communication options, that control TSM processing.

For current information about the installation and configuration of the TSM program product, refer to the README file on the product installation CDROM. For information about using the clients, see the books listed in Table 2. These books are in online-readable format on the TSM Online Product Library CD-ROM, order number SK2T-8779.

The Tivoli Data Protection application provides backup services for various databases on many platforms. Tivoli Data Protection publications are available in softcopy at the following URL:

Tivoli Storage Management home page-
http://www.tivoli.com/storage

Installation Overview

The TSM clients work in conjunction with the TSM server. Contact your TSM administrator to obtain client access to the TSM server, or refer to the following publications to install and configure a TSM server:

Table 3. TSM Server Quick Start Publications

Short Title Order Number
TSM for AIX Quick Start GC35-0367
TSM for AS/400 Quick Start GC35-0317
TSM for HP-UX Quick Start GC35-0370
TSM for MVS and OS/390 Quick Start GC35-0376
TSM for Sun Solaris Quick Start GC35-0373
TSM for Windows NT Quick Start GC35-0379

Although the details differ from platform to platform, installing and setting up the TSM clients requires these steps:

  1. Insure the client environment prerequisites for your TSM supported client platform are met, see Chapter 2, "Client Environments".
  2. Install the client program on your workstation. During this step, you select the client components you want to install. For example, you can install the GUI or command-line versions of the backup-archive client or administrative client (command line only), or you can install the API.

    If you want to use TSM to manage data automatically according to a schedule, be sure to install the backup-archive command-line client that includes the client scheduler. On most platforms, the schedule command is used to start the client scheduler. You can also set up the client scheduler to start automatically when you start your machine.

  3. Set environment variables to identify the locations of certain TSM files. This is usually an optional step because most clients set these variables during installation. If you move the client code, you might need to change these variables.
  4. Copy and modify the sample options file. TSM uses options to control its processing. For example, options determine which communication method TSM uses to transfer data.

    For UNIX clients, the options are in three options files: client system options file, client user options file, and include-exclude options file. This allows for greater flexibility in multi-user systems. All other clients use a single options file, usually referred to as the client options file.

  5. Register the workstation as a client node with a TSM server. Once registered, you can begin using TSM to manage your data.

See the following publications for additional information on using the TSM clients:

Table 4. TSM Client Publications

Short Title Order Number
TSM for Macintosh Using the Backup-Archive Client SH26-4103
TSM for NetWare Using the Backup-Archive Client SH26-4100
TSM for OS/2 Using the Backup-Archive Client SH26-4099
TSM for Windows Using the Backup-Archive Clients SH26-4101
TSM for UNIX Using the Backup-Archive Clients SH26-4105

Installing Clients from a CD-ROM

All TSM clients, except the OS/390 UNIX client, are included on the UNIX client and desktop client installation CD-ROMs. See Program Directory for Tivoli Storage Manager Client for OS/390 UNIX System Services, GI10-4529, for information about available OS/390 UNIX client installation media. You can install the clients using any of the following methods:

If you want to copy all of the clients to your server workstation so that client workstations can get the files from the x:\tsmcli directory, a Windows example would be the following command:

xcopy h:\tsmcli\*.* x:\ /s
Note:All of the examples in this chapter use the h drive as the CD-ROM or mounted drive. Substitute h with the CD-ROM drive of your system.

Client Installation Directory Structure

The client images, except the OS/390 UNIX client, are contained in TSM product CD-ROMs for the UNIX clients and the desktop clients. They are in the tsmcli/'platform'/ directory structure, where 'platform' is one of the following platform designations: Tru64, hp11, linux, mac, ntw, os2, unixware, numaq, sgi, sol26, win32. The AIX client images are in the /usr/sys/inst.images directory.

To install a client directly from the CD-ROM, you must install the client that corresponds to the operating system of your machine. For example, to install the Windows client, you must place the desktop client CD-ROM in the CD-ROM drive of your Windows machine.

You will need a BinHex converter to convert the TSM Macintosh installation file before you install it. Programs such as Stuffit Deluxe and Compact Pro can convert the files. In addition, BinHex 4.0, a freeware program, can be found at most major FTP sites including ftp.apple.com, and from online services such as, CompuServe and America Online.

National Language Support (NLS)

National language support (NLS) permits the TSM clients to display help messages and text in languages other than American English. The following are the TSM client platforms and their supported languages:

AIX
American English, Brazilian Portuguese, Italian, Chinese (Simplified), Chinese (Traditional), French, German, Japanese, Korean, Spanish

HP-UX
American English, Chinese (Simplified), Chinese (Traditional), Japanese, Korean

Macintosh
American English

NetWare
American English

OS/2
American English, Brazilian Portuguese, Italian, Chinese (Simplified), Chinese (Traditional), French, German, Japanese, Korean, Spanish

Solaris
American English, Chinese (Simplified), Chinese (Traditional), Japanese, Korean

Windows
Intel: American English, Brazilian Portuguese, Italian, Chinese (Simplified), Chinese (Traditional), French, German, Japanese, Korean, Spanish

Alpha: American English, Brazilian Portuguese, Italian, French, German, Spanish

For AIX, HP-UX, and Solaris: specify the language with the LANG environment variable. For all other UNIX platforms the language is American English.

For UNIX platforms that require CDE: running the backup-archive GUI outside the CDE desktop could result in errors due to unresolved fonts. Ensure all required fonts are available for your language environment when running the backup-archive GUI outside the CDE desktop. See "Setting Environment Variables (Optional)" for more information.

For NetWare, Macintosh, OS/2, and Windows: Currently, for Macintosh and NetWare you can use American English (AMENG) only. For OS/2 and all Windows clients, specify the language with the TSM language option. See Language for more information.

Online Startup Information

You can display online startup information, product manuals, and readmes. On a Web browser:

  1. Select File menu> Open File item.
  2. Select the CD-ROM drive.
  3. Select the START.HTM file.

Communication Protocols

To communicate with a TSM server, a client node can use one of the communication protocols in Table 5, that is specified for its operating system.


Table 5. Communication Protocols by Client

Protocol Macintosh NetWare OS/2 UNIX Windows NT, 2000 Windows 95, 98
IPX/SPX
x x
x x
Named Pipes

x
x
NETBIOS

x
x
Shared Memory

x x2

SNA LU6.2
x x x1 x x
TCP/IP x x x x x x
Note:
  1. AIX only
  2. AIX, HP-UX, and Solaris only


See Communication Options for more information about using communications options.


Installing the Online Books

All TSM books are available in online readable format using IBM BookManager, Adobe Acrobat Reader, or a Web browser. The BookManager, Acrobat Reader, and HTML versions are available on the TSM Online Product Library CD-ROM (SK2T-1396), and other CD-ROMs listed in Related Publications.

The booklets included with the CD-ROMs explain how to install the online books and readers on each user machine, or on a LAN drive. Because the online books and readers are large, installing them on a LAN drive that multiple users can access can save a lot of disk space.

In addition to reading the TSM books online, you can print the books. Consult the online documentation for the reader programs for information about printing online books. The quality of the printout depends on the reader program you use, and your printer capability.

Consult the CD-ROM booklet and the reader's documentation for information about using the reader programs.


Migrating from Earlier Versions

Terminology Changes

Previous versions of this product were known as ADSTAR Distributed Storage Manager (ADSM). ADSM is now known as Tivoli Storage Manager. Other terminology changes within this book are identified in the table below.

Previously Known As Now Known As
ADSM backup-archive client TSM backup-archive client or backup-archive client
ADSM backup-archive Web client or Web client TSM backup-archive Web client, Web client or Enterprise Management Web client
ADSM HSM Tivoli Space Manager or HSM client
ADSM AFS/DFS backup clients TSM AFS/DFS backup clients
ADSM server TSM server, Tivoli ADSM server or server

Some commands have changed names between Version 3.1 and Version 3.7. The commands continue to work the same as they did in Version 3.1. For this release of the product, you may continue to use the previous name. Name changes are shown in the table below:

Previous Command Name Current Command Name
eventback backup eventlog
eventrest restore eventlog
regback backup registry
regrest restore registry

Processing Virtual Mount Points

Use the AFS/DFS backup clients to process virtual mount points for AFS/DFS filesystems. Version 3 and higher backup-archive clients do not process virtual mount points specified for AFS/DFS filesystems. Using Version 3 or higher backup-archive clients to process virtual mount points for AFS/DFS file systems will expire the AFS/DFS file systems backed up by the Version 2 backup-archive client and back up the data under the root directory.

ACL Support

Beginning with Version 3.7.2, TSM provides full ACL support for the following clients:

Each previously backed up file that has an ACL set must be backed up again, even if the file has not changed. This ensures that the ACL data is updated on the server.

Enhancements for Dsmcutil Cluster Support

The dsmcutil.exe /group option has been renamed to /clustername. The /group option continues to work for this release; however, it is strongly recommended that you use /clustername to ensure future compatibility.

Additional Migration Information

When you install the Web client, you must install the client for the language you want to use.

A command line administrative client is available on all client platforms except Macintosh and NetWare. Version 3.7 does not include a native GUI administrative interface. Version 3.1 for Windows 95, Windows 98 and Windows NT included a native GUI administrative interface that can be used with Version 3.7. The primary intended interface to the server is the Web administrative interface and requires a Web browser. The Web administrative interface has enhanced functionality such as server-to-server communication, more device classes, and enhanced libraries and drives compared to the Version 3.1 administrative interface. The Web administrative interface is packaged and installed with the server.

TSM Version 3.7 clients restore or retrieve backup or archive data from previous Version 3 clients. However, previous Version 3 clients cannot access a Version 3.7 client's backup or archive data, regardless of the TSM server version. This is because Version 3.7 backup-archive clients store files with different attributes than previous version clients. After installing a Version 3.7 client, TSM may update the attributes only (not data) for active Version 3 files on the TSM server during the first incremental backup.

In addition, previous Version 3.7 clients cannot access backup or archive data from Version 3.7.2 clients because Version 3.7.2 backup-archive clients store files with different attributes than previous version clients.

Version 3.7 clients can perform backup, archive, restore, and retrieve functions with a Version 2 OS/2 server or a Version 3.1 ADSM server. However, many client features added with Version 3.7 are only available when using a TSM Version 3.7 server.

You cannot use the Version 3.7 TSM Web backup-archive client with a Version 2 server.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]