2. General Outline

The installation or upgrade procedure depends on the distribution and version of Linux you are using. For most Linux distributions you can install the TSM client from the IT Services HFS repository. You first download and install a package that configures your system to use the HFS repository. You then install the TSM client from that repository which means all dependencies will be automatically installed and also you will automatically get TSM client updates alongside all your other software updates.

The Linux repositories are signed. If you wish to confirm the signing key refer to Checking the repository signing key.

For Linux distributions that don't have repository support you can download and install from rpm files, or for distributions that don't support rpm (e.g. Gentoo) we provide a tar file that can be used to install the TSM client.

When installing the TSM client for the first time the HFS-packaged TSM Client will ask for your nodename, password, and whether you want to run scheduled backups, and will then automatically configure the TSM software correctly to connect to the HFS service.

Provided it finds an existing valid configuration the installer will upgrade that configuration without any further input on your part. If you were previously running scheduled backups the installer will stop the old scheduler before upgrading the software then restart it afterwards. It will upgrade your dsm.opt and dsm.sys configuration files.

If something does go wrong with the upgrade process your old configuration files will have been saved with the suffix .SAVE, for example as /opt/tivoli/tsm/client/ba/bin/dsm.opt.SAVE.

If it can work out how to do it, the installer will create a desktop menu item for Tivoli Storage Manager. When you select this you will usually be prompted for a password to enable you to run this with administrative privileges.

The TSM Linux client installs into /opt/tivoli/tsm/client/ with some additional files placed in /usr/bin. The GSKit packages installed as a dependency install into /usr/local/ibm.

The relevant executables are:

dsmj The Java GUI client
dsmc The command line client
dsmtca The 'trusted client agent', which allows non-root users to connect to the HFS

A file /etc/TIVGUID is created the first time a client is run. This file holds the Global Unique Identifier that associates a TSM client with a TSM server and should not be edited or removed.

The password for the HFS account will be stored in an encrypted form, readable only by root, in /etc/adsm/TSM.PWD.

If you have installed from the HFS repository you will get TSM client updates along with all your other system updates.

If you have specific installation problems then email hfs@ox.ac.uk attaching /opt/tivoli/tsm/client/ba/bin/tsm-install.log. This describes what the post installation scripts have attempted to do, and highlights any problems. It may also be required to email the following files: dsm.sys, dsm.opt.

Up: Contents Previous: 1. Progress Checker Next: 3. The HFS repository