HowTo: Install TSM Client on CentOS/RHEL

This guide describes the process of installation and basic configuration of TSM (Tivoli Storage Manager) Client on CentOS/RHEL.

Downloading the TSM Client

Download the archive with the latest TSM Client for your OS from IBM public FTP.

For example, lets download and unpack TSM Client 6.3.1.0 for Centos 6.3 64-Bit:

# mkdir -p /tmp/tsminstall
# cd /tmp/tsminstall
# wget ftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/client/v6r3/Linux/LinuxX86/BA/v631/6.3.1.0-TIV-TSMBAC-LinuxX86.tar
# tar xvf 6.3.1.0-TIV-TSMBAC-LinuxX86.tar

After unpacking you should see the following files:

README_enu.htm
README_api_enu.htm
TIVsm-API64.x86_64.rpm
TIVsm-BA.x86_64.rpm
TIVsm-BAhdw.x86_64.rpm
TIVsm-JBB.x86_64.rpm
TIVsm-APIcit.x86_64.rpm
TIVsm-BAcit.x86_64.rpm
TIVsm-filepath-6.3.1-0-rhel55.x86_64.rpm
TIVsm-filepath-6.3.1-0-rhel60.x86_64.rpm
TIVsm-filepath-6.3.1-0-sles10sp3.x86_64.rpm
TIVsm-filepath-6.3.1-0-sles11sp1.x86_64.rpm
gskcrypt64-8.0.14.14.linux.x86_64.rpm
gskssl64-8.0.14.14.linux.x86_64.rpm

The packages that are needed for installation are highlighted.

Installing TSM Client

1. Resolving Dependences

Install gskcrypt and gskssl. Normally, these libraries can be found in an archive with the TSM Client.

# rpm -ivh gskcrypt64-8.0.14.14.linux.x86_64.rpm
# rpm -ivh gskssl64-8.0.14.14.linux.x86_64.rpm

2. Installing TSM Client

Use yum localinstall to installing TSM client from rpm files. In this case the enabled repositories will be used to resolve dependencies.

# yum localinstall TIVsm-API64.x86_64.rpm
# yum localinstall TIVsm-BA.x86_64.rpm

You can remove the temporary folder, if the installation has completed successfully.

# rm -rf /tmp/tsminstall

TSM Client Configuration

Add the TSM client service to autostart:

# chkconfig --add dsmcad
# chkconfig dsmcad on

Create configuration files from the samples:

# cd /opt/tivoli/tsm/client/ba/bin/
# cp dsm.opt.smp dsm.opt
# cp dsm.sys.smp dsm.sys

Open configuration files and append your settings.

The content of /opt/tivoli/tsm/client/ba/bin/dsm.sys – Example:

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

The content of /opt/tivoli/tsm/client/ba/bin/dsm.opt – Example:

SErvername TSM-SERVER-1

TSM Server Configuration

Register the new node on your TSM Server.

Perform the following steps in the TSM Server’s console, if you haven’t registered the new node yet.

1. Register the new node

tsm> register node [NODE-NAME] [NODE-PASSWORD] domain=[DOMAIN]

Example:

tsm> register node CLIENT-NODE-12345 PASSW0RD domain=STANDARD

2. Associate the new node with a schedule

tsm> define assoc [DOMAIN] [SCHEDULE] [NODE-NAME]

Example:

tsm> define assoc STANDARD INCR_20H CLIENT-NODE-12345

These step are enough. Now logout and go back to your server.

Completing the TSM Client Configuration

Establish the first connection to TSM server from the client:

# dsmc query session

Enter the ‘user id’ (the name of your node) and the ‘password’.

If the session was successfully established, the password will be stored, and you won’t need to type it anymore.

Start the TSM client service:

# service dsmcad start

In a few minutes check the last schedule logs. Verify that the next backup has been successfully scheduled.

# tail /opt/tivoli/tsm/client/ba/bin/dsmsched.log

In case of any problems check the last error logs:

# tail /opt/tivoli/tsm/client/ba/bin/dsmerror.log

Good Luck and Have Fun!