Setting IBM Storage Protect client options on Windows

IBM Storage Protect™ clients on Windows™ are configured by setting options in the file server_a.opt, where server_a is the logical server name in the initSID.utl file. The include/exclude file is also used to define which files are included or excluded during backup, archive, or hierarchical storage processing.

About this task

To configure the IBM Storage Protect backup/archive clients to operate in an SAP environment, complete the following steps:

Procedure

  1. Install the IBM Storage Protect client software on the SAP database server system.
  2. For each logical IBM Storage Protect server, a corresponding client option file is needed. In this example, the file name must be server_a.opt since server_a is the logical server name:
    TCPPort           1500
    TCPServeraddress  xxx.xxx.xxx.xxx
    InclExcl          c:\tivoli\tsm\baclient\inclexcl.list
    Compression       OFF
    In addition, the environment variable DSMI_CONFIG must specify the corresponding client options file (for example c:\tivoli\tsm\api\server_a.opt).
  3. Specify TCPServeraddress 127.0.0.1 or loopback if the server and client are on the same system. 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.

Results

An IBM Storage Protect error log (required for each client) can be specified for each process regardless of the number of IBM Storage Protect client option files server.opt involved. The IBM Storage Protect error log is determined by these rules:
  1. The IBM Storage Protect client log is written to the file specified by the DSMI_LOG environment variable.
  2. If the DSMI_LOG environment variable is absent or is not writeable, the IBM Storage Protect client log is written to the file specified with keyword ERRORlogname in the client system options file dsm.opt.
  3. If there is no ERRORlogname in dsm.opt or if it is not writeable, the IBM Storage Protect client log is written to file dsierror.log in the local path.

Set up the IBM Storage Protect client so that different processes write to separate error logs. The error log path must be defined in the DSMI_LOG environment variable if the client options files are shared among processes.