HONDA UK Manufacturing - ISD

>

AIX TSM Client Installation and Configuration

Version 0.5

Author: Ian Peyman

Date: 19th March 2014

Extract

Document provides detailed information on how to install a TSM client on AIX

Page 1 of 5
 HONDA UK Manufacturing - ISD

 Change History

Date Who Vers Description

19/03/14 Ian Peyman 0.1 Initial draft document for review
01/04/2014 Andy Hart 0.2 Recommend to backup /etc/inclexcl before upgrading/installing
03/04/2014 Andy Hart 0.3 Added details for creating/linking to missing dsmclientV3.cat file
08/04/2014 Andy Hart 0.4 Updates to log file perms for GALC users to run backups
09/04/2014 Andy Hart 0.5 Update ~/ba/bin64 directory perms for non-root users

 Approvers

Who
Ian Peyman – AIX Infrastructure Specialist

 Circulation List

Infrastructure Team – ALL

Page 2 of 5
 HONDA UK Manufacturing - ISD

There are many compatibility considerations when upgrading a TSM client. See the link below for
information on this :

http://www-01.ibm.com/support/docview.wss?uid=swg21053218

At the time of writing the TSM server version is: 5.3

The compatibility information above defines that TSM client at version 6.2 is backward compatible with a
TSM server at 5.5 (I know is newer than our server version but...) and will run on AIX 5.3, 6.1 and 7.1.

Current code location :

NIML01: /software/TSM/6.2.0_clientx64
NIML01: /software/TSM/6.2.5.0_clientx64

My Installation Steps

UPGRADE
 Confirm current OS level
# oslevel -s

 Stop instances of the TSM client process.

 Take a copy of the following files :

/usr/tivoli/tsm/client/ba/bin/dsm.opt
/usr/tivoli/tsm/client/ba/bin/dsm.sys
/etc/inclexcl.txt

 Server already had a working TSM 5.3 client. I decided to uninstall this before proceeding with
the install. This will leave the configured dsm.opt and dsm.sys in place.

 Install version 6.2.0. Do not select xlsmp and xlC file sets are these are likely to be installed and
will screw up your OS version.
GSKit8.gskcrypt32.ppc.rte 8.0.13.3
GSKit8.gskcrypt64.ppc.rte 8.0.13.3
GSKit8.gskssl32.ppc.rte 8.0.13.3
GSKit8.gskssl64.ppc.rte 8.0.13.3
tivoli.tsm.client.api.32bit 6.2.0.0
tivoli.tsm.client.api.64bit 6.2.0.0
tivoli.tsm.client.ba.64bit.base 6.2.0.0
tivoli.tsm.client.ba.64bit.common 6.2.0.0
tivoli.tsm.client.ba.64bit.hdw 6.2.0.0
tivoli.tsm.client.ba.64bit.image 6.2.0.0
tivoli.tsm.client.ba.64bit.nas 6.2.0.0
tivoli.tsm.client.ba.64bit.snphdw 6.2.0.0
tivoli.tsm.client.ba.64bit.web 6.2.0.0
tivoli.tsm.client.jbb.64bit 6.2.0.0
tivoli.tsm.filepath.rte 2.2.0.21

 Install updates. I installed 6.2.5.

 Other file sets may be installed/updated. You will need to do an UPDATE_ALL on the OS to
maintain the OS level.

 Copy dsm.opt and dsm.sys to the new install directory : /usr/tivoli/tsm/client/ba/bin64

 Edit file dsm.sys

Ensure entries for log files (if they exist) reference this directory
*-----------------------------------------------------------
* Schedule log output file name.
*------------------------------------------------------smi-----
SCHEDLOGNAME "/usr/tivoli/tsm/client/ba/bin64/dsmsched.log"

Page 3 of 5
 HONDA UK Manufacturing - ISD

*
*-----------------------------------------------------------
* Error log output file name.
*-----------------------------------------------------------
ERRORLOGNAME "/usr/tivoli/tsm/client/ba/bin64/dsmerror.log"

 Update log file permissions

# chmod go+rw /usr/tivoli/tsm/client/ba/bin64/dsmsched.log
# chmod go+rw /usr/tivoli/tsm/client/ba/bin64/dsmerror.log
# > /usr/Tivoli/tsm/client/ba/bin64/dsmprune.log
# chmod go+rw /usr/tivoli/tsm/client/ba/bin64/dsmprune.log

 Update Directory permissions

# chmod go+w /usr/Tivoli/tsm/client/ba/bin64 (required if non-root users execute dsmc)

 Update entries in /etc/inittab to start the TSM client at boot time

# chitab "dsmc:2:once:/usr/tivoli/tsm/client/ba/bin64/dsmc schedule >/dev/null
2>/dev/null"
# chitab "dsmcsch:2:once:/usr/tivoli/tsm/client/ba/bin64/dsmcad >/dev/null
2>/dev/null"

NEW INSTALLATION
 Same as above but no need to copy existing files out of the way.
o Configure dsm.sys & dsm.opt
o Create/configure /etc/inclexcl

CONFIRMATION
 Start the client
echo "/usr/tivoli/tsm/client/ba/bin64/dsmcad" | at now
echo "/usr/tivoli/tsm/client/ba/bin64/dsmc schedule" | at now

(will need to supply tsm agent passwd if starting for first time)

NOTE: if starting dsmc from commandline complains about missing “dsmclientV3.cat”

file, earlier testing on AIX6.1 client with $LANG=en_GB required:

# cd /usr/Tivoli/tsm/client/ba/bin64
# ln -s /usr/tivoli/tsm/client/lang/EN_US EN_GB

, and testing on AIX5.3 client with $LANG=EN_US required:

# cd /usr/Tivoli/tsm/client/ba/bin
# mkdir EN_US
# cp /usr/Tivoli/tsm/client/ba/bin64 ./EN_US/.

 Check the log files for errors

/usr/tivoli/tsm/client/ba/bin64/dsmsched.log
/usr/tivoli/tsm/client/ba/bin64/dsmerror.log

 If there are errors its possible the client was unable to connect to the TSM server. Log onto
the TSM client to confirm this and correct (may need Scott's assistance here)
root@ewsrv-2: /usr/tivoli/tsm/client/ba/bin64 # dsmc
IBM Tivoli Storage Manager
Command Line Backup-Archive Client Interface
Client Version 6, Release 2, Level 5.0
Client date/time: 11/12/13 09:02:54
(c) Copyright by IBM Corporation and other(s) 1990, 2013. All Rights Reserved.

Node Name: EWSRV-2

NOTE : enter the node name and password if required although this should already be set.

Page 4 of 5
 HONDA UK Manufacturing - ISD

 Run a manual backup to ensure client functionality. Use the 'incr' command and select a
directory to backup. Look in the '/etc/inclexcl.txt' for a list of directories that are backed up
and select one to test from there. The '-su=yes' decends sub directories.
tsm> incr /admin -su=yes

 This will complete with output similar to below.

Total number of objects inspected: 138,145

Total number of objects backed up: 732
Total number of objects updated: 0
Total number of objects rebound: 0
Total number of objects deleted: 0
Total number of objects expired: 52
Total number of objects failed: 0
Total number of bytes inspected: 6.93 GB
Total number of bytes transferred: 23.31 MB
Data transfer time: 0.99 sec
Network data transfer rate: 23,908.43 KB/sec
Aggregate data transfer rate: 29.82 KB/sec
Objects compressed by: 0%
Total data reduction ratio: 99.68%
Elapsed processing time: 00:13:20

Again check for errors and seek Scott's assistance if there is.

Page 5 of 5