Tivoli Header

Tivoli Storage Manager for UNIX Backup-Archive Clients Installation and User's Guide

Setting Processing Environment Variables

There are three environment variables you can set which affect Tivoli Storage Manager 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 default installation directory.

When you request an image or a NAS backup or restore, Tivoli Storage Manager uses the DSM_DIR environment variable to locate the corresponding plug-in library. If DSM_DIR is not set, the client will look for the plug-in library in the following directories: /usr/tivoli/tsm/client/ba/bin/plugins for AIX and AIX 5L, or /opt/tivoli/tsm/client/ba/bin/plugins for Solaris.

DSM_CONFIG
Contains the fully-qualified path and file name of the client user options file for users who create their own personalized options file.

If DSM_CONFIG is not set, the client user options file is expected to satisfy both of these requirements:

  1. The options file should be named dsm.opt
  2. The options file should reside in the directory pointed to by DSM_DIR

However, if DSM_DIR is not set, then dsm.opt is expected in the default installation directory.

DSM_LOG
Points to the directory where you want the dsmerror.log, dsmwebcl.log, and dsmsched.log files to reside. The dsmerror.log file cannot be a symbolic link. In addition, you cannot specify the root directory for DSM_LOG. The error log file contains information about any errors that occur during processing. The client creates the error log to help the Tivoli Storage Manager technical support team diagnose severe errors.

If you define DSM_LOG, Tivoli Storage Manager writes messages to dsmerror.log, dsmwebcl.log, and dsmsched.log files in the directory you specify.

If you define DSM_DIR, but not DSM_LOG, Tivoli Storage Manager writes messages to dsmerror.log, dsmwebcl.log, and dsmsched.log in the directory specified by DSM_DIR.

If you do not define DSM_LOG or DSM_DIR, Tivoli Storage Manager writes messages to dsmerror.log, dsmwebcl.log, and dsmsched.log files in the current directory.

If you use the errorlogname option to specify the fully qualified path where you want to store the dsmerror.log file, this value overrides the definitions in the DSM_LOG or DSM_DIR environment variables. The dsmwebcl.log and dsmsched.log files will be created in the same directory as dsmerror.log.

When Tivoli Storage Manager cannot write to the log file, it issues a warning message.


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