Tivoli Storage Manager for UNIX Using the Backup-Archive Clients


Chapter 2. Getting Started

This chapter includes instructions for the following tasks:

Task Page
"Setting Environment Variables" "Setting Environment Variables"
"Starting TSM the First Time" "Starting TSM the First Time"
"Starting a GUI Session" "Starting a GUI Session"
"Starting a Command Line Session" "Starting a Command Line Session"
"Starting A Web Client Session" "Starting A Web Client Session"
"Changing Your Password" "Changing Your Password"
"Displaying Online Help" "Displaying Online Help"
"Ending a Session" "Ending a Session"

Setting Environment Variables

Use the lang environment variable to specify the language for the AIX, HP-UX, and Solaris clients.

dsm*fontList: -dt-interface system-medium-r-normal-xs*-*-*-*-*-*-*-*-*:

There are three environment variables you can set which affect TSM processing:

DSM_DIR
Points to the executable file dsmtca, the resource files, and the dsm.sys file. You cannot specify the root directory for DSM_DIR. If DSM_DIR is not set, the executables are expected in the installation directory.

DSM_CONFIG
Points to the client user options file for users who create their own personalized options file. You cannot specify the root directory for DSM_CONFIG. If DSM_CONFIG is not set, the options file is expected in the directory pointed to by DSM_DIR. If DSM_DIR is not set, then the options file is expected in the installation directory.

DSM_LOG
Points to the directory where you want the dsmerror.log file to reside. You cannot specify the root directory for DSM_LOG. The error log file contains information about any errors that occur during processing. The error log is intended for the TSM technical support team to help you diagnose severe errors.

If you define DSM_LOG, TSM writes messages to dsmerror.log in the directory you specify.

If you do not define DSM_LOG, but DSM_DIR is defined, TSM writes messages to dsmerror.log in the directory specified by DSM_DIR.

If neither DSM_LOG nor DSM_DIR is defined, TSM writes messages to dsmerror.log in the current directory.

If you use the errorlogname option to specify where you want TSM to write messages, it will override any definitions to DSM_LOG or DSM_DIR.

If TSM cannot write to the log file, it issues a warning message and continues processing.

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. When running the backup-archive GUI under Motif, and outside the CDE desktop, add the following entry to the .Xdefaults file in your home directory:

Setting Bourne and Korn Shell Variables

For the Bourne or Korn shell, enter the environment variables in the .profile file in your $HOME directory. For example:

   DSM_DIR=/home/davehil
   DSM_CONFIG=/home/davehil/dsm.opt
   DSM_LOG=/home/davehil
   export DSM_DIR DSM_CONFIG DSM_LOG

Where /home/davehil/dsm.opt is the path and file name for your client user options file, and /home/davehil is the directory where you want to store the dsmerror.log file, executable file, resource files, and dsm.sys file.

Setting C Shell Variables

For the C shell, add the DSM_CONFIG, DSM_LOG and DSM_DIR variables to .cshrc in your $HOME directory. For example, if /home/davehil/dsm.opt is the path and file name of your client user options file, and /home/davehil is the directory in which you want to store the dsmerror.log file:

   setenv DSM_CONFIG /home/davehil/dsm.opt
   setenv DSM_LOG /home/davehil

Starting TSM the First Time

TSM authorized user

The following information assumes that you have installed TSM. If you have not installed TSM, see Installing the Clients, SH26-4119, for installation information.

If you plan to use a Web client with an enterprise management server, ensure that you were assigned an administrative user id with system privilege, policy privilege, client access, or clientowner authority.

Before you can use TSM, you must register your client with the server. The process of setting up a node name and password is called registration, and is performed by your administrator.

TSM provides two types of registration: open and closed. Your administrator chooses the type of registration for your site.

Using Closed Registration

With closed registration, an administrator must register your workstation as a client node with the server. If your enterprise uses closed registration, you need to provide the following information to your administrator:

In addition to possibly defining certain options in your options file, your administrator defines the following for you:

Using Open Registration

With open registration, you can register your workstation as a client node with the server.

The first time you start a session, TSM prompts you for information necessary to register your workstation with the server identified in your options file. You need to supply your node name, a password, and contact information.

When you use open registration:

If necessary, your administrator can change these defaults later.

Starting the X Window System

Before you can start a session with the TSM graphical user interface, the X Window System must be running on your workstation. If you do not have the X Window System running on your workstation, use the command-line interface.

To make your workstation behavior and appearance more like UNIX, you can use the rlogin command to log on to UNIX System Services instead of using the 3270 terminal emulation.


Starting a GUI Session

If the X Window System is running, check if a session is already started; look on your workstation desktop for the Tivoli Storage Manager icon.

If you see the Tivoli Storage Manager icon on your desktop, TSM is already running. Double-click the icon to open the TSM window. If the Tivoli Storage Manager icon does not display on your desktop, you must start TSM with a command. You can run in the foreground or background. To run in the foreground, enter:

   dsm

To run in the background, enter:

   dsm &

Your administrator can require you to use a password to connect to the server. TSM prompts you for the password, if one is required. Contact your administrator if you do not know your password. See Changing Your Password for information about changing your password.

Attention: If you are working on an AIX workstation, and you want to back up or archive AFS or DFS files, check with the root user responsible for setting up TSM on your workstation to find out whether you can use the AFS or DFS version of TSM. See Using the AFS/DFS Backup Clients for more information.

If you are working on an AIX workstation, and you want to back up or archive AFS or DFS files, check with the root user responsible for setting up TSM on your workstation to find out if you can use the AFS or DFS version of TSM. See Using the AFS/DFS Backup Clients for more information.

Configuration Wizard

When the GUI client starts initially and does not find an options file, a setup wizard displays to guide you through the configuration process. You can also display the setup wizard by selecting Utilities>Setup Wizard from the TSM main window. To perform configuration tasks, follow instructions on the screen. The Setup Wizard is not available through the Web client.


Starting a Command Line Session

An alternate way to start the client is from the command line. However, if TSM does not find an options file, it displays an error message and stops processing. In that case, see your administrator to determine the name of the options file TSM should use.

Start a command line session using one of the following methods:

See Chapter 10, "Using Commands" for complete information on how to start and use the command-line client.

Attention: If you are working on an AIX workstation, and you want to back up or archive AFS or DFS files, check with the root user responsible for setting up TSM on your workstation to find out whether you can use the AFS or DFS version of TSM. See "Using the AFS/DFS Backup Clients" for more information.


Starting: Additional Considerations

You can include options as arguments to dsm and dsmc commands. For example, you can use options to modify the format that displays dates, times, and numbers, or to include your password so that TSM does not prompt for it. However, if you include the password option, your password can be seen by anyone who sees you enter the command.

In addition, if you have more than one server available to you, and you want to contact a different server for backup-archive services other than the one specified in your client user options file, specify the server with the servername option. For example:

   dsm -servername=server_b

Starting A Web Client Session

You can use the Web client to perform backup, archive, restore, and retrieve operations from machines or platforms that support at least a Java 1.1.6-capable browser, such as Netscape Navigator 4.06 or higher, or Microsoft Internet Explorer 4.01 or higher. Using the Web client, you can back up and restore your own data, or an administrator can centralize the backup or restore operations of many clients. To use the Web client, specify the URL of the client machine running the Web client in your Web browser. The Web client is only supported on a server that is Version 3 or higher.

Installing and Using the Web Client

If the Web client was not installed during the installation process, you can use the command line to install and configure it.

To install and configure the Web client from the command line, perform the following steps:

  1. If you do not have a client password file, specify passwordaccess generate in the dsm.sys options file. For more information on passwordaccess, see Passwordaccess.
  2. To generate the TSM password, start the native backup-archive client by entering:

    dsmc query session
    

    and, when prompted, enter your user id and password. For important information about how passwords operate on the native client and the Web client, see 5.

  3. Quit from the native TSM backup-archive client.
  4. Start the client acceptor service by entering:
    dsmcad
    

    The Web client agent service starts automatically when needed.

    The only options you can use with the dsmcad command are optfile, httpport, and httpsport.

    All Web client messages are written to the Web client log file, dsmwebcl.log. Error messages are written to the error log file. The dsmwebcl.log file and the error log file are located in the directory specified by the errorlogname option. See Chapter 8, "Setting Common Options" for more information.

  5. To use a Web client with an enterprise management server, ensure that you were assigned an administrative user id with system privilege, policy privilege, client access, or clientowner authority. If your server does not support enterprise management, then use your node name and password when prompted by the Web client.
    Note:Use the revokeremoteaccess option to restrict an administrator with client access privilege from accessing your workstation through the Web client. Administrators with client owner privilege, system privilege, or policy privilege can access the Web client. For more information see Revokeremoteaccess.
  6. To access the Web client, enter the following URL from any supported browser:
    http://your_machine_name:1581
    

    where your_machine_name is the hostname of the machine running the Web client.

    Port 1581 is the default port number. Your administrator can set a different port number using the httpport option. See Httpport for more information.

    The Web client workstation can also be accessed through the Web administrative GUI. To use the Web client on AIX with secure socket layer (SSL) communications, see Tivoli Storage Manager Installing the Clients, SH26-4119.


Starting the Client Scheduler Automatically

ROOT USER

You can start the client scheduler automatically when you start your machine. If the administrator has defined schedules for your node, starting the client scheduler permits TSM to automatically back up your machine (or perform other scheduled actions). See Chapter 5, "Automating TSM Tasks" for more information about the client scheduler.


Changing Your Password

Your administrator can require you to use a password to connect to the server. TSM prompts you for the password if one is required. Contact your administrator if you do not know your password.

If you are using passwords, you should change them regularly to restrict access to your data.

To change your password from the GUI:

  1. Select Utilities>Change password.
  2. Enter your current and new passwords, and enter your new password in the Verify password field.
  3. Click Change.

To change your password from the command line, enter:

   dsmc set password

Then, enter your old and new passwords.

A TSM password can be up to 64 characters. Valid characters are:

Character Description
A-Z Any letter; A through Z, upper or lower case
0-9 Any number; 0 through 9
+ Plus
. Period
_ Underscore
- Hyphen
& Ampersand

A password is not case sensitive.

The following are additional password information sources:


Sorting File Lists

You can sort a list of files by various attributes, such as name, directory, size, or modification date. Sorting files by the last backup date can be useful in determining what date and time to use for the point-in-time function (see "Performing Point-in-Time Restores").

To sort a file list, select one of the Sort by items from the View menu bar. Or, click the appropriate column heading in the File List box.

The Show active/inactive files menu option controls whether TSM lists both active and inactive backup versions of files. TSM only lists the active backup versions of files during a session, unless the Show active/inactive files menu option is selected. An active file is the most recent backup version of a file that existed on your workstation when you ran your last backup. All other backup versions of that file are called inactive. If you delete the file from your workstation, the active version becomes inactive the next time you run an incremental backup.


Displaying Online Help

You can display online help in any one of the following ways:


Online Forum

To participate in online user discussions of TSM, subscribe to an Internet Listserv forum. This is not officially supported by TSM, but support people do participate in the discussions, along with other users.

You can subscribe by sending a note to Listserv@vm.marist.edu that contains:

 subscribe adsm-l yourfirstname yourlastname

Posts can then be sent to adsm-l@vm.marist.edu.


Other Sources of Online Help

An anonymous FTP server is available where you can find PTF maintenance and other TSM- related materials. In addition, four other anonymous servers are unofficially maintained by non-IBM volunteers. These servers are:

 ftp.software.ibm.com        (primary - Colorado, IBM)
 ftp.wu-wien.ac.at            (mirror  - Austria)
 ftp.cac.psu.edu              (mirror  - Pennsylvania) 
 sunsite.unc.edu/pub/packages (mirror  - North Carolina)

If you have the required username and password, you can get maintenance information from the TSM support page at http://www.tivoli.com/support/storage_mgr/tivolimain.html.


Contacting Customer Support

For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways:

Customers in the United States can also call 1-800-TIVOLI8 (1-800-848-6548). For product numbers 5697-TS9, 5697-DRS or 5697-DPM call 1-800-237-5511.

International customers should consult the Web site for customer support telephone numbers.

You can also review the Customer Support Handbook, which is available on our Web site at http://www.tivoli.com/support/handbook/.

When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site.

The support Web site offers extensive information, including a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases.

You can order documentation by e-mail at swdist@tivoli.com. Please provide the publication number, part number, or order number of the desired document. Alternatively, you can provide the document title, version number, and date of publication.

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 contact us in one of the following ways:


Ending a Session

You can end a TSM session in any one of the following ways:


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