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