Please note that beginning January 1, 2004 AIX 4.3.3 will no longer be supported by IBM.

Installing the TSM 5.1 client under IBM AIX 4.3.3

These instructions will guide you through the installation and configuration of the Tivoli Storage Manager client, so you can back up your data using DoIT's Bucky Backup service. You should be familiar with the AIX operating system distribution and have root or root-equivalent access to the machine you are working with. These instructions and the AIX client are specific to the pSeries & RS/6000 architecture.

Data that has been backed up or archived from a TSM v5.1 client cannot be restored or retrieved to any previous level client. The data must be restored or retrieved by a v5.1.0 or higher level client. Once you migrate to 5.1 you cannot go back to an older client (but you can certainly restore older data). This is non-negotiable. You have been warned.

This product installs into /usr/tivoli/tsm/client. It requires 40 to 50 megabytes of space. During the installation SMIT will extend the filesystem if you do not have enough space. If you do not have space in rootvg, you can symlink /usr/tivoli/tsm/client into a directory where you do have enough space.

You must have registered a node and have received confirmation of your node name. Make sure you know the password that you specified when applying for the node.

You must have xlC.rte installed in order to install the client. If you wish to use the graphical client under AIX you must have AIXwindows X11R6, Motif 1.2 or Motif 2.0, and the CDE installed.

Acquire the software from Tivoli. You can use wget or lynx to retrieve the files from their web site (or use the "Save Target As..." feature of your browser):

ftp://service.boulder.ibm.com/storage/tivoli-storage-management/maintenance/client/v5r1/

Start SMIT to install the software:

smitty install

Select "Install and Update Software", then "Install and Update from LATEST Available Software". When it prompts you for the "INPUT device / directory for software" specify the directory in which you saved the installation files. Proceed to install the software ("_all_latest")

Change to the new directories created for the client:

cd /usr/tivoli/tsm/client/ba/bin

Create and edit the dsm.sys, dsm.opt, and inclexcl files for your system. Sample files are linked. At a minimum, you will have to edit dsm.sys and insert your node name.

Start dsmc by using the ./dsmc command. Enter the command "query schedule" and you will be prompted for your node's password. Enter your password and press enter. Once it successfully displays the node's backup schedule, enter the command "quit" to exit it. This saves your node's password, so that backups and other operations can happen automatically.

To start the TSM client on reboot, edit /etc/inittab and insert the line (all one line):

tsm:2:once:/usr/tivoli/tsm/client/ba/bin/dsmc schedule servername=bucky3 > /dev/null 2>&1 < /dev/null

Issue the following command on the command line, as root, to manually start dsmc:

nohup /usr/tivoli/tsm/client/ba/bin/dsmc schedule -servername=bucky3>/dev/null &

Verify that the client has started and is working by checking the log files in /usr/tivoli/tsm/client/ba/bin.

You can perform a manual backup to test your settings using the command:

/usr/tivoli/tsm/client/ba/bin/dsmc incremental

Remember that if you change the settings in dsm.sys, dsm.opt, or inclexcl you need to restart the software.

Upgrading the TSM client from 4.2 to 5.1

To upgrade the TSM client from 4.2.1 to 5.1 use the following procedure:

1. Obtain a copy of the software (use the links at the top of this page).
2. Kill the running copy of dsmc (a "ps -ef | grep dsmc" will show you what is running. Kill the parent process).
3. Back up dsm.opt, dsm.sys, and inclexcl from your old configuration (probably in /usr/tivoli/tsm/client/ba/bin). The upgrade will preserve them, but it pays to have a backup copy.
4. Upgrade the TSM client packages using "smitty install". Select "Install and Update Software", then "Update Installed Software to Latest Level (Update All)". Specify the directory in which the software was downloaded.
5. Edit your dsm.sys file and ensure that the TCPServeraddress flag is set to buckybackup2.doit.wisc.edu OR buckybackup3.doit.wisc.edu (this just ensures future compatibility with changes to the service). This setting could be either server, depending on when you registered your node.
6. Restart dsmc using the command:
   
   nohup /usr/tivoli/tsm/client/ba/bin/dsmc schedule -servername=bucky2 >/dev/null &
7. Watch your logs to ensure that a backup happened. You can also invoke a manual backup using "dsmc incremental" from the command line.