Tivoli AIX Client

Introduction

Installing and configuring the tsm client software on AIX.

Download

Download the latest software from the IBM website

Install software :

mkdir /tmp/tivoli
cp /exports/install/ibm/Tivoli\ Storage\ Manager/5.5.1.0-TIV-TSMBAC-AIX.tar.Z /tmp/tivoli
cd /tmp/tivoli
uncompress 5.5.1.0-TIV-TSMBAC-AIX.tar.Z
tar -xvf 5.5.1.0-TIV-TSMBAC-AIX.tar
smit install

install :
- tivoli.tsm.client.api.32bit
- tivoli.tsm.client.ba
  - select the complete product

Config files :

/usr/tivoli/tsm/client/ba/bin/dsm.sys:

************************************************************************
* IBM Tivoli Storage Manager                                           *
************************************************************************

DEFAULTServer   company-backup

SErvername      company-backup
   NodeName             <fill in short hostname, aka "mailserver">
   COMMmethod           TCPip
   TCPServeraddress     <server dns name>
   TCPPort              1500
   PAsswordAccess       generate
   ENcryptKey           save
   errorlogname         /var/log/backuperrors.log
   schedlogname         /var/log/backupsched.log

/usr/tivoli/tsm/client/ba/bin/dsm.opt:

************************************************************************
* IBM Tivoli Storage Manager                                           *
************************************************************************

* Which server to use by default.
DEFAULTServer   company-backup

* Mischellaneous client options.
COMPRESSAlways  no

Add these lines to /etc/inittab:

itsm::once:/usr/bin/dsmc schedule >/dev/null 2>&1 #TSM scheduler
itsm2::once:/usr/bin/dsmcad >/dev/null 2>&1 #TSM web client

Check

Check the client and see it's schedule:

dsmc
tsm> q sched

Check when the latest backup was:

dsmc
tsm> q fi

N.B. Note that you need the correct username and password for this the first time you start the program.

Manual startup

Start the scheduler in the background with the command :

nohup dsmc schedule 2>/dev/null &
nohup dsmcad 2>/dev/null &

Restore

To restore a backup you need to go to the following adress using your webbrowser: http://<server>:1581/BACLIENT

Note that in case you don't see anything or receive error messages the dsmcad has probably failed. Restart the service using the command above. Choose the option restore from backup from the menu and a popup will appear to ask for your credentials. After filling in your credentials a new screen will popup and you'll have access to the restore function.
Also note that you need to have a java runtime environment installed on your local machine to access the web client.
Click on the File level folder. In the file level folder you can see which filesystems are currently being backed up. If you push the point of time button you can change the backup date. You can browse through the filesystems in the right panel where you can select the files to be restored by putting a mark for it. When you're done with your selection you can click the restore button. The files can be restored to another directory if needed. You can specify so after clicking the restore button.

Troubleshooting

If an AIX server loses network connectivity for a period longer then one hour it's possible that the TSM client will get in an error state. In this state the client cannot connect to the TSM server to poll its schedule. Even when networkconnectivity is restored the TSM client will stay in an error state until the process has been killed and restarted. Type ps -ef | grep -i dsmc to see the schedulers process then kill it with -9. Afterwards run the nohup command from above to start the service.
If you get errormessages when trying to log in into dsmc remove the /etc/security/adsm/TSM.PWD file and restart dsmc. You can now enter the correct password.

Remove / Uninstall the Tivoli AIX Client

Smitty install
- Software Maintenance and Utilities
  - Remove Installed Software

Expand the 'SOFTWARE name' list and select: (with F7)

tivoli.tsm.client.api.32bit
tivoli.tsm.client.ba.32bit.base
tivoli.tsm.client.ba.32bit.common
tivoli.tsm.client.ba.32bit.image
tivoli.tsm.client.ba.32bit.nas
tivoli.tsm.client.ba.32bit.web

SUCCESSES
---------
  Filesets listed in this section passed pre-deinstall verification
  and will be removed.
    -- Filesets are listed in the order in which they will be removed.
    -- The reason for deinstalling each fileset is indicated with a keyword
       in parentheses and explained by a "Success Key" following this list.

  tivoli.tsm.client.ba.32bit.base 5.5.1.0 (Selected)
    TSM Client - Backup/Archive Base Files

  tivoli.tsm.client.ba.32bit.image 5.5.1.0 (Selected)
    TSM Client - IMAGE Backup Client

  tivoli.tsm.client.ba.32bit.nas 5.5.1.0 (Selected)
    TSM Client - NAS Backup Client

  tivoli.tsm.client.ba.32bit.web 5.5.1.0 (Selected)
    TSM Client - Backup/Archive WEB Client

  tivoli.tsm.client.ba.32bit.common 5.5.1.0 (Selected)
    TSM Client - Backup/Archive Common Files

  tivoli.tsm.client.api.32bit 5.5.1.0 (Selected)
    TSM Client - Application Programming Interface

Cleanup Files:

rm -rf /usr/tivoli/
rm /var/log/dsmwebcl.log
rm /var/log/dsmsched.log
rm /var/log/backuperrors.log

Remove these lines from /etc/inittab:

itsm::once:/usr/bin/dsmc schedule >/dev/null 2>&1 #TSM scheduler
itsm2::once:/usr/bin/dsmcad >/dev/null 2>&1 #TSM web client

aix, backup

Discussion