Installing TSM Client on CentOS/RHEL

This guide describes the process of installing and basic configuration of the Tivoli Storage Manager Client on CentOS/RHEL.

Downloading the Client

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

For example, let's download and unpack TSM Client 7.1.6.2 for CentOS 6.3 64-Bit:

# mkdir tsm
# cd tsm
# wget ftp://public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/client/v7r1/Linux/LinuxX86/BA/v716/7.1.6.2-TIV-TSMBAC-LinuxX86.tar
# tar xvf 7.1.6.2-TIV-TSMBAC-LinuxX86.tar

After unpacking you should see the following files:

gskcrypt64-8.0.50.66.linux.x86_64.rpm
gskssl64-8.0.50.66.linux.x86_64.rpm
README_api_enu.htm
README_enu.htm
TIVsm-API64.x86_64.rpm
TIVsm-APIcit.x86_64.rpm
TIVsm-BAcit.x86_64.rpm
TIVsm-BAhdw.x86_64.rpm
TIVsm-BA.x86_64.rpm
TIVsm-filepath-7.1.6-0-rhel59.x86_64.rpm
TIVsm-filepath-7.1.6-0-rhel64.x86_64.rpm
TIVsm-filepath-7.1.6-0-rhel7.x86_64.rpm
TIVsm-filepath-7.1.6-0-sles11sp2.x86_64.rpm
TIVsm-filepath-source.tar.gz
TIVsm-JBB.x86_64.rpm

Installing the 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.50.66.linux.x86_64.rpm
# rpm -ivh gskssl64-8.0.50.66.linux.x86_64.rpm

2. Installing TSM Client

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

# 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 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 the configuration files and append your settings.

Example: dsm.sys

SErvername saverestore.its.psu.edu
COMMMethod TCPip
TCPPort 1500
TCPServeraddress saverestore.its.psu.edu
PASSWORD <your password>
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

Example: dsm.opt

SErvername saverestore.its.psu.edu

Getting Connected

Establish the first connection to the TSM Server from the client:

# dmsc query session

If the session was successfully established, you should see:

IBM Tivoli Storage Manager
Command Line Backup-Archive Client Interface
  Client Version 7, Release 1, Level 6.2 
  Client date/time: 09/09/2016 11:23:06
(c) Copyright by IBM Corporation and other(s) 1990, 2016. All Rights Reserved. 

Node Name: <NODE NAME>
Session established with server SAVERESTORE.ITS.PSU.EDU: AIX
  Server Version 6, Release 3, Level 6.0
  Server date/time: 09/09/2016 11:23:06  Last access: 09/09/2016 10:38:00

TSM Server Connection Information

Home Server Name........: SAVERESTORE.ITS.PSU.EDU
Server Type.............: AIX
Archive Retain Protect..: "No"
Server Version..........: Ver. 6, Rel. 3, Lev. 6.0
Last Access Date........: 09/09/2016 10:38:00
Delete Backup Files.....: "No"
Delete Archive Files....: "Yes"
Deduplication...........: "Server Only"

Node Name...............: <NODE NAME>
User Name...............: <USER NAME>

Secondary Server Information
Not configured for failover

Start the TSM Client service with:

# service dsmcad start

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

# 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

Backing Up

To incrementally back up data, use the incr command followed by the desired directories.

tsm> incr /

To run an incremental backup by date backup by date, add the -incrbydate option. This will only back up new and changed files with a modification date later than the last incremental backup stored on the server.

tsm> incr / -incrbydate

To back up entire disk volumes irrespective of whether files have changed since the last backup, use the selective command with a wildcard and -subdir=yes.

tsm> sel /* -su=yes

Querying Files

If you're interested in checking what files get backed up, you can run a query. The syntax is q ba <path>; adding a wildcard and -subdir=yes will display all files contained within the specified path.

tsm> q ba /var/www/html       

           Size        Backup Date                Mgmt Class           A/I File
           ----        -----------                ----------           --- ----
         4,096  B  09/13/2016 08:39:38         DLT-4-3-31-1096          A  /var/www/html

Restoring Files

tsm> rest /var/www/html/index.html /var/www/html/backup.html

Files can also be restored using the PITDate or PITTime commands. Dates can be formatted in the following ways: http://www.ibm.com/support/knowledgecenter/SS8TDQ_6.4.0/com.ibm.itsm.srv.ref.doc/r_cmd_node_restore.html#r_cmd_node_restore

Guide