Setting IBM Storage Protect client options on UNIX or Linux

Edit online

IBM Storage Protect™ clients on UNIX™ or Linux™ are configured by setting options in the dsm.opt and dsm.sys files. The include/exclude file is used to define which files are included or excluded during backup, archive, or hierarchical storage processing.

About this task

Configure the IBM Storage Protect backup-archive client to operate in an SAP environment with the following procedure.

Procedure

  1. Install the IBM Storage Protect client software on the SAP database server system.
  2. Edit the client system options file dsm.sys and set these values as appropriate for your installation: 
    Servername        server_a
TCPPort           1500
TCPServeraddress  xxx.xxx.xxx.xxx or servername
InclExcl          /usr/tivoli/tsm/client/ba/bin/inclexcl.list
Compression       OFF
  3. Specify TCPServeraddress 127.0.0.1. If the server and client are on the same system, select loopback. This selection improves TCP/IP communication speed.
  4. Specify InclExcl if you want IBM Storage Protect to include or exclude the files that are listed in inclexcl.list.
    You might want to exclude all database files that are processed by the BR*Tools. DB2® database backup.
  5. Throughput improves when tape drives attached to the IBM Storage Protect server provide hardware compression. However, combining hardware compression and IBM Storage Protect client software compression (Compression ON) is not advised. It might be necessary to experiment with IBM Storage Protect client software compression settings to determine its impact in your environment. IBM Storage Protect client software compression generally improves performance only when network throughput is low.
  6. Edit the client user options file dsm.opt and set these values as appropriate for your installation: 
    LANGUAGE     AMENG   (this is the default value)
NUMBERFormat 1       (this is the default value)
TAPEPROMPT   NO
TIMEFORMAT   1       (this is the default value)

Results

When the IBM Storage Protect API client is installed on a UNIX or Linux system, ensure that a link exists that points to the IBM Storage Protect API installation directory, /usr/tivoli/tsm/client/api/bin64.
  • /usr/lib/libApiDS.ext
  • /usr/lib/libApiDS.a
  • /usr/lib/libApiDS.so

The IBM Storage Protect provides two features for specifying the location of the IBM Storage Protect API Client error log: the environment variable DSMI_LOG and the IBM Storage Protect system client option ERRORLOGName in dsm.sys. For DSMI_LOG, a directory is specified to which a file named dsierror.log is written. For ERRORLOGName a path and user-defined file name are defined.

To achieve conclusive logical linking of the environment, configuration and log files in your SAP backup-archive system, you must use the IBM Storage Protect system client option ERRORLOGName rather than the environment variable DSMI_LOG.
  • When you use ERRORLOGName, you can include the SID in the file name. This information can speed up problem determination by simplifying identification of the correct error log file. You can match log file names to the active user client options file name, which must also contain the SID and be stored in environment variable DSMI_CONFIG. This information is especially useful on systems with several SIDs.
  • The suggested configuration prepares the system for IBM Storage Protect API Client tracing for both backint and RMAN operation.
The following is the suggested setup for Data Protection for SAP for DB2 on AIX®:
  1. For each SERVER servername section in the profile initSID.utl, create a corresponding SErvername servername stanza in the system client options file /usr/tivoli/tsm/client/api/bin64/dsm.sys, where SID designates the DB2 database name as returned by echo $DB2DBDFT. One SID might use several SErvername servername stanzas. It is not advised to use SErvername <servername stanza by several SIDs.
  2. In all SErvername servername stanzas that belong to the same SID, add option ERRORLOGName /writeable_path/dsierror_SID.log. Write permission problems can usually be avoided by specifying a directory below $HOME of the DB2 instance owner as writeable_path.
  3. Create one user options file for each DB2 SID with the file name /usr/tivoli/tsm/client/api/bin64/dsm_SID.opt containing option SErvername servername. servername must point to the stanza in /usr/tivoli/tsm/client/api/bin64/dsm.sys that is designated by the first SERVER servernamesection in initSID.utl. Add variable DSMI_CONFIG=/usr/tivoli/tsm/client/api/bin64/dsm_SID.opt to the environment of the user who is running the SAP backups, db2SID or SIDadm, or both in case of doubt.
With this setup, you obtain the following logical interlinking:
  • Environment variable DSMI_CONFIG is exported from the login shell
  • Environment variable DSMI_CONFIG points to client user options file /usr/tivoli/tsm/client/api/bin64/dsm_SID.opt
  • Client user option SERVER servername in dsm_SID.opt points to the SERVER servername stanza in /usr/tivoli/tsm/client/api/bin64/dsm.sys
  • The SERVER servername stanza contains the option ERRORLOGName /writeable_path/dsierror_SID.log
If the variable DSMI_LOG exists in your environment from an earlier setup, it is overridden by dsm.sys option ERRORLOGName. However, to avoid confusion, make sure the DSMI_LOG path is identical to the path in ERRORLOGName. Alternatively, you can remove DSMI_LOG completely from your environment.