You are located in service: Backup & Restore



Konfiguration unter Linux

TSM-Server, Port-Nummer und Nodename des Backupknotens ermitteln



For optimization reasons (load distribution, performance, ...) several server instances (logical TSM servers) are operating on the backup system of the IT Center.

In order to be able to distribute resources optimally, carry out backup and restore processes as quickly as possible, nodes of a facility are not assigned to a fixed TSM server, but are usually set up on different TSM servers.


 To find out the corresponding information of your backup node, log into the Backup/Restore & Archive Self-Service Portal and click Backup in the left column under the Node tab.


To view the information, click the information("i") icon of the corresponding backup node in the table that appears.


Konfigurationsdatei anlegen



After installing the client software, the central configuration files (dsm.sys, dsm.opt) must be created.


To do this, execute the following commands.

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

Then use an editor of your choice to edit the dsm.sys.

The command to edit the file with an editor could be for example nano /opt/tivoli/tsm/client/ba/bin/dsm.sys.

Please copy the lower content of the dsm.sys and adjust the user-specific entries of the following parameters.

For this, use the data determined from the Backup/Restore & Archive Self-Service Portal(Link).



DEFAULTSERVER, SERVERNAME and TCPSERVERADDRESS all have the same entry in the form of

Replace the XX with the number of the according backup server.

With DOMAIN and VIRTUALMOUNTPOINT you define the directories to be backed up.

You can find more information about this in the content of dsm.sys.

Content of the dsm.sys
* dsm.sys option file for Unix Clients
* ---------------------------------------------------------------
* TSM-Server und Ports ermitteln und eintragen.
* z.B. TSM-Server (Port 1501)
TCPPORT                       15XX
* ---------------------------------------------------------------
* Die folgenden 5 Eintrage unveraendert lassen.
* Abweichungen sind mit dem IT Center abzusprechen!
COMMMETHOD                    tcpip
PASSWORDACCESS                generate
SCHEDMODE                     polling
TXNBYTELIMIT                  25600
MANAGEDSERVICE                schedule
* ---------------------------------------------------------------
* Geben Sie mit NODENAME den Namen des Rechners an, wie er
* im TSM-Server registriert ist. Der NODENAME wird beim
* Anlegen eines neuen Knotens ueber das Backup-Portal gesetzt.
* ----------------------------------------------------------------
* Festlegen der Logfiles
SCHEDLOGNAME                  /var/log/dsmsched.log
ERRORLOGNAME                  /var/log/dsmerror.log
* ----------------------------------------------------------------
* Haltezeit (Tage) fuer Eintraege im Scheduler- und Errorlogfile
* festlegen
* Schedulerlogdatei: 30 Tage
* Errorlogdatei    :  1 Jahr
* ----------------------------------------------------------------
* Mit 'DOMAIN' geben Sie die Verzeichnisse an, die Sie sichern
* wollen. Ein Verzeichnis, das kein Mountpoint eines Filesystems
* ist, muss zusaetzlich als VIRTUALMOUNTPOINT deklariert werden.
* Im nachfolgenden Beispiel sind /home und /etc fuer die
* Sicherung vorgesehen, wobei aber nur /home ein eigenes
* Filesystem ist.
DOMAIN                     /home
DOMAIN                     /etc
* ----------------------------------------------------------------
* Mit INCLUDE koennen einzelne Dateien aus zuvor ausgeschlossenen
* Bereichen mit in die Sicherung aufgenommen werden. Beachten,
* Sie, dass die Reihenfolge von EXCLUDE/INCLUDE-Statements
* relevant ist!
* Die folgenden Exclude-Statements werden vom TSM-Server
* vorgegeben und brauchen nicht definiert zu werden. Die
* Statements schliessen die Caches fuer Konqueror, Mozilla
* und Netscape sowie core-Files aus der Sicherung aus.
* EXCLUDE         '/.../.kde/share/cache/http/.../*'
* EXCLUDE         '/.../.mozilla/.../.../Cache/.../*'
* EXCLUDE         '/.../.netscape/cache/.../*'
* EXCLUDE         'core'
* EXCLUDE         '/.../dsmerror.log'
* EXCLUDE         '/.../dsmsched.log'
* ----------------------------------------------------------------
* Benutzerspezifische EXCLUDES und INCLUDES:
* ----------------------------------------------------------------



The parameter PASSWORDACCESS out of the configuration file (dsm.opt) generates a new, secure password for the client and server after the first entry of the node password.

This password is stored encrypted locally in the context of the current user and the entered password is discarded.

After the first connect with the backup node, it is no longer necessary to enter the password again.

For more information on the INCLUDE and EXCLUDE parameters, see the IBM documentation.



Abschließende Konfigurationen



Run the following command to add IBM Spectrum Protect to the init-system (systemd).

cp /opt/tivoli/tsm/client/ba/bin/dsmcad.service /usr/lib/systemd/system/

Type the following command to create an override file that will be additionally loaded by systemd when the service starts.

More information about this mechanism can be found here.

systemctl edit dsmcad

Copy this content into the new window and save the file.



These overwrites ensure that characters of all character encodings are properly backed up. Please use "en_US" only, even if you otherwise use a different character set in your system.

To ensure that the character encoding works properly when using the Interactive Console, please perform the following steps each time before starting the CLI or GUI:

export LANG=en_US
export LC_CTYPE=en_US

Then you can reload the systemd manager configuration to make the changes effective.

systemctl daemon-reload

Initial connect with the backup node

After all configurations have been made, you can establish the first connection to the backup node.

Run the dsmc in the console and enter the node name and the initial password.

After the successful Connect you can close the dsmc again with quit.



If the connection was successful and you have set the parameter PASSWORDACCESS to generate in dsm.sys, it should now be possible to execute the dsmc again without password confirmation.


Activate the automatic start of the Client Acceptor Daemon

Finally, the automatic start of the Client Acceptor Daemon (CAD) is activated and the configuration of the client software is completed.

systemctl enable dsmcad
systemctl start dsmcad

You should now see entries in the log files.

more /var/log/dsmsched.log

last changed on 07/14/2022

How did this content help you?

Creative Commons Lizenzvertrag
This work is licensed under a Creative Commons Attribution - Share Alike 3.0 Germany License