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 you can restore 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 in separate Web browsers. Do not perform such operations simultaneously in the same browser, or you may unintentionally destroy data that you need.

The Web client is available on the following 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/support/storage_mgr/tivolimain.html

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-0402
TSM for AS/400 Quick Start GC35-0317
TSM for HP-UX Quick Start GC35-0412
TSM for MVS and OS/390 Quick Start GC35-0415
TSM for Sun Solaris Quick Start GC35-0406
TSM for Windows Quick Start GC35-0409

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

  1. Ensure 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-4120
TSM for NetWare Using the Backup-Archive Client SH26-4116
TSM for Windows Using the Backup-Archive Clients SH26-4117
TSM for UNIX Using the Backup-Archive Clients SH26-4122

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 the following publications 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, linux86, mac, ntw, unixware, ptx, sgi, solaris, 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

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

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

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

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, and Windows:For Macintosh and NetWare you can use American English (AMENG) only. For the 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 UNIX Windows NT, 2000 Windows 95, 98
IPX/SPX
x


Named Pipes


x
NETBIOS


x
Shared Memory

x2

SNA LU6.2
x x1 x x
TCP/IP 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.


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, or Web client
ADSM HSM Tivoli Space Manager or HSM client
ADSM AFS/DFS backup clients TSM AFS/DFS backup clients
ADSM server TSM server or server

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 file previously backed up with a Version 3.7.1 or lower client, and which 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 client platforms. 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, enhanced libraries and drives, and is packaged and installed with the server.

Upgrade Path for Clients and Servers

As part of a migration plan from TSM Version 3.7 to TSM Version 4.1, TSM clients and servers may be upgraded at different times. To ensure that you can continue your backup and archive activities during the migration, note the following:


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