TSM Client Configuration File

The client options file is an editable file that identifies the server and communication method. It provides the configuration for backup, archiving, hierarchical storage management, and scheduling.

The configuration for the TSM client is defined in the following files depending on your OS:

Client OS Default configuration location Purpose
Windows C:\Program Files\Tivoli\TSM\baclient\dsm.opt Main TSM configuration file
Unix/Linux /opt/tivoli/tsm/client/ba/bin/dsm.sys Main TSM configuration file
Unix/Linux /opt/tivoli/tsm/client/ba/bin/dsm.opt Secondary TSM configuration file (used for dsmcad)

The Main TSM configuration file – Example

These are the minimum options required to get started using TSM:

$ cat /opt/tivoli/tsm/client/ba/bin/dsm.sys
   Servername                server_a
   COMMMethod                TCPip
   TCPPort                   1500
   TCPServeraddress          node.domain.company.com

The Secondary TSM configuration file – Example

We mainly need it if we use several TSM servers:

$ cat /opt/tivoli/tsm/client/ba/bin/dsm.opt
   Servername                server_a

Client Configuration File Options

Typical configuration options look like:

The SERVERNAME option specifies the name you want to use to identify a server.

SERVERNAME TSM-SERVER-1

The COMMMethod option specifies the communication method you use to provide connectivity for client-server communication.

COMMMethod         TCPip

The TCPPort option specifies a TCP/IP port address for a Tivoli Storage Manager server.

TCPPort            1500

The TCPServeraddress option specifies the TCP/IP address for a Tivoli Storage Manager server.

TCPServeraddress   192.168.0.5

The TCPCLIENTAddress option specifies a TCP/IP address if your client node has more than one address, and you want the server to contact an address other than the one that was used to make the first server contact.

TCPCLIENTAddress   192.168.0.200

The TCPCLIENTPort option specifies a different TCP/IP port number for the server to contact than the one that was used to make the first server contact.

TCPCLIENTPort      1501

The PASSWORDAccess option specifies whether you want to generate your password automatically or set as a user prompt.

PASSWORDAccess     generate

Use the NODename option in your client options file dsm.opt to identify your workstation to the server.

NODename           CLIENT-SERV-123456

The SCHEDMODe option specifies whether you want to use the polling mode (your client node periodically queries the server for scheduled work), or the prompted mode (the server contacts your client node when it is time to start a scheduled operation).

SCHEDMODe          PROMPTED

The INCLExcl option specifies the path and file name of an include-exclude options file.

INCLExcl           /opt/tivoli/tsm/client/ba/bin/inclexcl.def

The MANAGEDServices option specifies whether the Tivoli Storage Manager Client Acceptor service (CAD) manages the scheduler, the Web client, or both.

MANAGEDServices    schedule

The ERRORLOGName option specifies the fully qualified path and file name of the file in which to store information about errors that occur during processing.

ERRORLOGName       /opt/tivoli/tsm/client/ba/bin/dsmerror.log

The ERRORLOGRetention option specifies how many days to maintain error log entries before pruning, and whether to save the pruned entries.

ERRORLOGRetention  7 D

The SCHEDLOGName option specifies the path and file name where you want to store schedule log information.

SCHEDLOGName       /opt/tivoli/tsm/client/ba/bin/dsmsched.log

The SCHEDLOGRetention option specifies the number of days to keep entries in the schedule log, and whether to save the pruned entries.

SCHEDLOGRetention  7 D

The DEDUPLICATION option configures the client so that you can use data deduplication.

DEDUPLICATION YES

Displaying All Options

You can use the ‘query options’ command to display all or part of your options and their current settings relevant to the command-line client.

Display all options:

tsm> query options

Display only options beginning with sched:

tsm> query options sched*

My typical Configuration Files

Here are the typical configuration files that i use for deploying new TSM clients:

$ cat /opt/tivoli/tsm/client/ba/bin/dsm.sys
SErvername  TSM-SERVER-1
  COMMMethod         TCPip
  TCPPort            1500
  TCPServeraddress   192.168.0.5
  PASSWORDAccess     generate
  NODename           CLIENT-NODE-12345
  SCHEDMODe          PROMPTED
  MANAGEDServices    schedule
  ERRORLOGName       /opt/tivoli/tsm/client/ba/bin/dsmerror.log
  ERRORLOGRetention  7 D
  SCHEDLOGName       /opt/tivoli/tsm/client/ba/bin/dsmsched.log
  SCHEDLOGRetention  7 D
  DEDUPLICATION yes
$ cat /opt/tivoli/tsm/client/ba/bin/dsm.opt
SErvername  TSM-SERVER-1