Unix machines

The automation of the backup task must be done on the client side via cron for example. Please refer to the dedicated page on setting up a cron job.

The TSM client is configured mainly through two files:

/opt/tivoli/tsm/client/ba/bin/dsm.opt
/opt/tivoli/tsm/client/ba/bin/dsm.sys

To prevent a client update from affecting the configuration you have made, we recommend that you unpack the entire TSM configuration in a separate tree. We usually use /var/spool/tsm.

Create the tree

Create the TSM client configuration directory:

% mkdir -p /var/spool/tsm/{etc,log,lock,bin}

Copy the IBM template config files or those form the tsm-ccin2p3 package:

% cp /opt/tivoli/tsm/client/ba/bin/dsm.{opt,sys} /var/spool/tsm/etc/

or:

% cp /usr/share/doc/tsm-ccin2p3/etc/* /var/spool/tsm/etc/

Edit the config files

Backup server address

After contacting the TSM admins, they may have assigned you an alias such as tsm${LAB_NAME}.in2p3.fr (example: tsmlpnhe.in2p3.fr).

Attention

This alias must be used. In some cases, this alias does not exist or cannot be used, for example if you have backup nodes on different TSM servers. In the rest of the documentation ${SERVER_NAME} will have to be replaced by the server name you are assigned to.

Backup credentials

After contacting the TSM admins, you will be provided a node name (backup identifier) associated with a password.

Attention

In the rest of the documentation ${NODE_NAME} will have to be replaced by the node name you are assigned to.

File dsm.opt

This file specifies the server that the TSM client will try to contact when launching a backup:

% cat /var/spool/tsm/etc/dsm.opt
************************************************************************
* IBM Tivoli Storage Manager                                           *
*                                                                      *
* Sample Client User Options file for UNIX (dsm.opt.smp)               *
************************************************************************

*  This file contains an option you can use to specify the TSM
*  server to contact if more than one is defined in your client
*  system options file (dsm.sys).  Copy dsm.opt.smp to dsm.opt.
*  If you enter a server name for the option below, remove the
*  leading asterisk (*).

************************************************************************

* SErvername       A server name defined in the dsm.sys file

SErvername  ccin2p3

File dsm.sys

This file defines the known TSM backup profiles:

% cat /var/spool/tsm/etc/dsm.sys
************************************************************************
* IBM Tivoli Storage Manager                                           *
*                                                                      *
* Sample Client System Options file for UNIX (dsm.sys.smp)             *
************************************************************************

*  This file contains the minimum options required to get started
*  using TSM.  Copy dsm.sys.smp to dsm.sys.  In the dsm.sys file,
*  enter the appropriate values for each option listed below and
*  remove the leading asterisk (*) for each one.

*  If your client node communicates with multiple TSM servers, be
*  sure to add a stanza, beginning with the SERVERNAME option, for
*  each additional server.

************************************************************************

SErvername ccin2p3
        COMMMethod                      TCPip
        TCPPort                         1500
        NodeName                        ${NODE_NAME}
        PasswordAccess                  generate
        TCPServeraddress                ${SERVER_NAME}
        errorlogname                    "/var/spool/tsm/log/dsmerror.log"

Attention

Pay attention to specify the values of the options NodeName and TCPServeraddress.

Initial entry of the TSM password

The option PasswordAccess Generate from the config file dsm.sys allows the TSM client to remember the TSM password used to authenticate to the CC-IN2P3 backup servers. However, during the first configuration, you must enter this password at least once:

% /usr/bin/dsmc

IBM Storage Protect
Command Line Backup-Archive Client Interface
  Client Version 8, Release 1, Level 13.0
  Client date/time: 01/19/2023 19:38:47
(c) Copyright by IBM Corporation and other(s) 1990, 2021. All Rights Reserved.

Node Name: DEMO
Please enter your user id <DEMO>: (1)

Please enter password for user id "DEMO": (2)

Session established with server CCTSM9: Linux/x86_64
  Server Version 8, Release 1, Level 13.000
  Server date/time: 01/19/2023 19:38:49  Last access: 01/19/2023 11:56:15

Protect>

  1. Just press Enter ou type the TSM node that you need to use.

  2. Enter the initial password you received from the TSM administrators.

  3. If the dsm.sys or dsm.opt files are not found when dsmc starts, you will need to specify the path to these files in the DSM_DIR environment variable.