Quick Start Guide For Data Backup: Backup Archive Client Installation For Linux
Quick Start Guide For Data Backup: Backup Archive Client Installation For Linux
2 STEP
Install the program that may vary to different Linux distributions. Installation packages are available in two
different formats: RPM (RHEL, SLES, Centos, etc.) and DEB (Ubuntu, Debian).
2.1. Steps to be taken when choosing the RPM-based installation packages.
2.1.1. Install GSKit packages.
rpm -Uvh gskcrypt64-8.x.x.x.linux.x86_64.rpm gskssl64-8.x.x.x.linux.x86_64.rpm
2.1.2. Install Tivoli Storage Manager API.
rpm -ivh TIVsm-API64.x86_64.rpm
2.1.3. Make a backup installation for Java client, command line client, web client and the
documentation*:
rpm -ivh TIVsm-BA.x86_64.rpm
* This document does not cover the configuration of Java web client.
3.4. Make the necessary corrections in dsm.sys configuration file sample. Fill in fields marked with “?” sign
in the Custom settings field:
a) NODENAME: specify the backup node name, which was automatically assigned in BaaS portal, in the
field TSM Node id.
b) TCPSERVERADDRESS: specify the backup node server address, which was automatically assigned in
BaaS portal, in the field TSM server address.
Quick Start Guide on using Management (Cloud) portal can be found here.
3.5. Additional Settings section is for additional configurations (ssl, cripts, compressions, other
“management class”). These settings can be left by default.
3.6. Default Include/Exclude settings section is for changing exclusion lists. These settings can be left by
default.
3.7. Default settings section is for default configuration parameters. These settings can be left by default.
4 STEP
In order to save the password locally and for creating automatic data backup it is necessary to connect to
the program. Also, for safety reasons, it is necessary to change default password.
4.1. When connecting for the first time enter user id and password.
a) User id: TSM Node id or node name. It was given in clause 3.4. so keep it unchanged.
b) Password: Node password that was generated automatically when creating new node in BaaS
portal.
Quick Start Guide on using Management (Cloud) portal can be found here.
4.2. Run tsm command line program, which provides information on the parameters of the session with the
server:
dsmc q ses
4.3. Change password by entering current password and then entering new password:
dsmc set password
5 STEP
5.1. Set and configure the setup for creating data backup schedule that may vary to different Linux
distributions.
5.2. Steps to be taken when configuring the system service “dsmcad”. We recommend using “dsmcad” in the
following cases:
a) when using Linux distributions with the RPM-based installation package.
b) when using configuration file sample.
c) when not using ssl for connection with the backup server.
5.2.1. Add service with default settings for those system services that are launched automatically.
chkconfig --add dsmcad
5.2.2. Restart the service.
service dsmcad restart
5.3. Steps to be taken when configuring data backup schedule with system process “dsmc sched”. We
recommend using “dsmc sched” in the following cases:
a) when using Linux distributions with DEB-based installation package.
b) when not using dsmcad service.
c) when using ssl for connection with backup server.
Execute the command:
dsmc sched
5.3.1. In case of using “dsmc schedule” process, it is necessary to delete or comment the default setting
“managedservices schedule” of the configuration file dsm.sys (see Step 3) by adding at the beginning of
the line * or by replacing it with “managedservices webclient”, in case of using tsm web client.
5.3.2. In order to run the process with its staring at the same time, several technique may be used:
a) by creating rc script.
b) by adding system startup file /etc/inittab.
TSM::once:/usr/bin/dsmc sched > /dev/null 2>&1 # TSM scheduler
c) by adding system startup file /etc/rc.local.
/usr/bin/dsmc sched > /dev/null 2>&1 &
Warning. In order to activate changes, it is necessary to restart process “dsmc schedule” each time when
changing TSM client configurations.
6 STEP
6.1. Make a backup copy to random folder in order to check whether the system works correctly and to enter
and save the encryption key.
a) For successful creation of automated data backup with switched encryption, it is necessary to specify
the encryption key. Encryption key will be required at the first backup time.
b) Make a manual data backup by using the command line dsmc. For example, run the incremental
backup for folder /root/, its sub-folder and for their files by using Linux console:
dsmc Incremental /root/ -subdir=yes
6.2. Enter encryption key.
Warning. Keep the encryption key in a safe place, as no data will be available without a key!
7 STEP (optional)
Data restore by using command line dsmc
7.1. Possible action sequences:
a) To run BAclient and then execute commands.
b) To run BAclient with already defined parameters.