6. TSM client installation

Make sure you have installed the repository package as described in the previous section, then follow the instructions in the appropriate section below depending on your distribution

Alternatively, if the repository doesn't support your distribution follow the instructions for manual rpm installation, if your system supports rpm packages, or tar file installation

6.1. Debian based distributions (e.g. Debian, Ubuntu)

6.1.1. Installing the TSM client

You can install the TSM client using apt:

  1. Make sure the universe repository is enabled in /etc/apt/sources.list
  2. Update your list of packages with apt-get update
  3. To install the full TSM client including GUI support do apt-get install tsm-client
  4. Alternatively to install the command line only TSM client do apt-get install tsm-client-base
  5. The selected package as well as some packages it depends on (including gskcrypt32 and gskssl32 for TSM 6.2 or gskcrypt64 and gskssl64 for later versions) will be installed. For new installs you will be prompted for your TSM nodename and password and will be asked whether you want to run scheduled backups.

It is also possible to install the TSM client with GUI tools. However the details vary between distributions so are not covered here.

6.1.2. Upgrading the TSM client

If you are upgrading from TSM 6.1, 5.5 or 5.4 first install the ox-hfs-repo package as described above.

Usually the TSM client will be updated alongside all your other software updates. If you want to upgrade just the TSM client run the following two commands (as root, or prefixed with sudo):

 apt-get update 
 apt-get install tsm-client 

or

 apt-get update 
 apt-get install tsm-client-base 

if you have only the tsm-client-base package installed.

If your upgraded configuration is not working and you would like to start with a fresh configuration then run:

 dpkg-reconfigure tsm-client-base

This will ignore your old configuration files and prompt you for your Nodename and Password, and whether you want to run scheduled backups.

If the update was successful, you can continue to use the TSM client as previously. Your scheduled backups should also continue to function as previously.

6.2. Red Hat based distributions (e.g. Red Hat Enterprise Linux, Fedora, CentOS, Scientific Linux)

6.2.1. Installing the TSM client

You can install the TSM client using yum:

  1. Make sure you are logged in as root
  2. To install the full TSM client including GUI support do yum install tsm-client
  3. Alternatively to install the command line only TSM client do yum install tsm-client-base
  4. The selected package as well as some packages it depends on (including gskcrypt32 and gskssl32 for TSM 6.2 or gskcrypt64 and gskssl64 for TSM 6.3) will be installed.
  5. Run /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh. This will prompt for a Nodename, Password, and whether to start the scheduler.

It is also possible to install the TSM client with GUI tools. However you will still need to run /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh as root after installation.

6.2.2. Upgrading the client

If you are upgrading from TSM 6.1, 5.5 or 5.4 first install the ox-hfs-repo package as described above.

Usually the TSM client will be updated alongside all your other software updates. If you want to upgrade just the TSM client run the following commands as root:

 yum update tsm-client 

or

 yum update tsm-client-base 

if you have only the tsm-client-base package installed.

If your upgraded configuration is not working and you would like to start with a fresh configuration then run:

/opt/tivoli/tsm/client/ba/bin/HFSsetup.sh reconfigure

This will ignore your old configuration files and prompt you for your Nodename and Password, and whether you want to run scheduled backups.

If the update was successful, you can continue to use the TSM client as previously. Your scheduled backups should also continue to function as previously.

6.3. SUSE distributions

6.3.1. Installing the TSM client

You can install the TSM client using zypper:

  1. Make sure you are logged in as root
  2. To install the full TSM client including GUI support do zypper install tsm-client
  3. Alternatively to install the command line only TSM client do zypper install tsm-client-base
  4. The selected package as well as some packages it depends on (including gskcrypt32 and gskssl32 for TSM 6.2 or gskcrypt64 and gskssl64 for TSM 6.3) will be installed.
  5. Run /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh. This will prompt for a Nodename, Password, and whether to start the scheduler.

It is also possible to install the TSM client with GUI tools. However the details vary between distributions so are not covered here. You will still need to run /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh as root after installation.

6.3.2. Upgrading the client

If you are upgrading from TSM 6.1, 5.5 or 5.4 first install the ox-hfs-repo package as described above.

Usually the TSM client will be updated alongside all your other software updates. However, because of the change from 32-bit to 64-bit software you will not be automatically updated to 6.3 from an earlier version. In this case, or if you want to just install the TSM client and not other packages, run the following commands as root:

 zypper update tsm-client tsm-client-base

or

 zypper update tsm-client-base 

if you have only the tsm-client-base package installed.

If your upgraded configuration is not working and you would like to start with a fresh configuration then run:

/opt/tivoli/tsm/client/ba/bin/HFSsetup.sh reconfigure

This will ignore your old configuration files and prompt you for your Nodename and Password, and whether you want to run scheduled backups.

If the update was successful, you can continue to use the TSM client as previously. Your scheduled backups should also continue to function as previously.

6.4. Mandriva/Mageia distributions

6.4.1. Installing the TSM client

You can install the TSM client using urpmi:

  1. Make sure you are logged in as root
  2. To install the full TSM client including GUI support do urpmi tsm-client
  3. Alternatively to install the command line only TSM client do urpmi tsm-client-base
  4. The selected package as well as some packages it depends on (including gskcrypt32 and gskssl32 for TSM 6.2 or gskcrypt64 and gskssl64 for TSM 6.3) will be installed.
  5. Run /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh. This will prompt for a Nodename, Password, and whether to start the scheduler.

It is also possible to install the TSM client with GUI tools. However the details vary between distributions so are not covered here. You will still need to run /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh as root after installation.

6.4.2. Upgrading the client

If you are upgrading from TSM 6.1, 5.5 or 5.4 first install the ox-hfs-repo package as described above.

Usually the TSM client will be updated alongside all your other software updates. However, because versions up to 6.2 were 32-bit while later versions are 64-bit software you will not be past 6.2. If you are running TSM 6.2 or earlier on a 64-bit system you must first uninstall the old version by doing:

urpme tsm-client tsm-client-base gskcrypt64 gskssl64

if your current version is TSM 6.2, or

urpme tsm-client 

if your current version is 6.1 or earlier. Then install the latest TSM client as described above.

If you want to just install the TSM client and not other packages, run the following commands as root:

 urpmi tsm-client 

or

 urpmi tsm-client-base 

if you have only the tsm-client-base package installed.

If your upgraded configuration is not working and you would like to start with a fresh configuration then run:

 /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh reconfigure

This will ignore your old configuration files and prompt you for your Nodename and Password, and whether you want to run scheduled backups.

If the update was successful, you can continue to use the TSM client as previously. Your scheduled backups should also continue to function as previously.

6.5. Manual RPM Install

6.5.1. Installing

Install the HFS rpm signing key

 rpm --import ftp://ftp.hfs.ox.ac.uk/repo/rpm/repodata/repomd.xml.key

Download all the RPM files from ftp://ftp.hfs.ox.ac.uk/repo/rpm/ for 64-bit Linux or from from ftp://ftp.hfs.ox.ac.uk/repo/62/rpm/ for 32-bit Linux

For 64-bit Linux install all the downloaded packages with

 rpm -i ox-hfs-repo.rpm tsm-client-6.4.1.7-1.x86_64.rpm tsm-client-base-6.4.1.7-1.x86_64.rpm gskcrypt64-8.0-14.26.x86_64.rpm gskssl64-8.0-14.26.x86_64.rpm

or if you only want the command line client

rpm -i ox-hfs-repo.rpm tsm-client-base-6.4.1.7-1.x86_64.rpm gskcrypt64-8.0-14.26.x86_64.rpm gskssl64-8.0-14.26.x86_64.rpm

For 32-bit Linux install all the downloaded packages with

 rpm -i ox-hfs-repo.rpm tsm-client-6.2.5.0-4.i386.rpm tsm-client-base-6.2.5.0-4.i386.rpm gskcrypt32-8.0-14.6.i386.rpm gskssl32-8.0-14.6.i386.rpm

or if you only want the command line client

 rpm -i ox-hfs-repo.rpm tsm-client-base-6.2.5.0-4.i386.rpm gskcrypt32-8.0-14.6.i386.rpm gskssl32-8.0-14.6.i386.rpm

If this complains about missing dependencies (for example compat-libstdc++-33) you will need to find and install those packages for your distribution. If the dependent libraries are actually installed you can try using the --nodeps switch to install ignoring dependencies. If you can't meet dependencies for the tsm-client package try omitting that - you may still be able to install the command line only package. (Note that the ox-hfs-repo package is installed even though you can't use a repository as as it is a dependency of the tsm-client-base package).

To automatically configure the client run: /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh. This will prompt for a Nodename, Password, and whether to start the scheduler.

6.5.2. Upgrading

Follow the instructions above for installation only use rpm -U option in place of rpm -i, that is for 64-bit clients

 rpm -U ox-hfs-repo.rpm tsm-client-6.4.1.7-1.x86_64.rpm tsm-client-base-6.4.1.7-1.x86_64.rpm gskcrypt64-8.0-14.26.x86_64.rpm gskssl64-8.0-14.26.x86_64.rpm

or if you only want the command line client

rpm -U ox-hfs-repo.rpm tsm-client-base-6.4.1.7-1.x86_64.rpm gskcrypt64-8.0-14.26.x86_64.rpm gskssl64-8.0-14.26.x86_64.rpm

or, for 32-bit clients,

 rpm -U ox-hfs-repo.rpm tsm-client-6.2.5.0-4.i386.rpm tsm-client-base-6.2.5.0-4.i386.rpm gskcrypt32-8.0-14.6.i386.rpm gskssl32-8.0-14.6.i386.rpm

or if you only want the command line client

 rpm -U ox-hfs-repo.rpm tsm-client-base-6.2.5.0-4.i386.rpm gskcrypt32-8.0-14.6.i386.rpm gskssl32-8.0-14.6.i386.rpm

If the update was successful, you can continue to use the TSM client as previously. Your scheduled backups should also continue to function as previously.

However, if your configuration is not working after the upgrade and you would like to start with a fresh configuration then run:

 /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh reconfigure

Then follow the installation instructions. This will ignore your old configuration files and prompt you for your Nodename and Password, and whether you want to run scheduled backups.

6.6. Installing using the tar file (e.g. Gentoo)

6.6.1. Installing the TSM client (64-bit systems)

Download the gzipped tar file from ftp://ftp.hfs.ox.ac.uk/repo/tar/tsm-client-6.4.1.7-1.tgz

Install the software by untarring the file from the root directory.

After the TSM software has been unpacked, to automatically configure the client run: /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh. This will prompt for a Nodename and Password, and whether you want to run scheduled backups. (If you are using a system with a startup script system significantly different to that used on Debian and Redhat systems, e.g. Gentoo, you may have to manually configure the scheduler to start).

For example:

 cd /tmp 
 wget ftp://ftp.hfs.ox.ac.uk/repo/tar/tsm-client-6.4.1.7-1.tgz 
 cd / 
 su - 
 tar -xhzf /tmp/tsm-client-6.4.1.7-1.tgz 
 /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh 

6.6.2. Installing the TSM client (32-bit systems)

Download the gzipped tar file from ftp://ftp.hfs.ox.ac.uk/repo/62/tar/tsm-client-6.2.5.0-4.tgz

Install the software by untarring the file from the root directory.

After the TSM software has been unpacked, to automatically configure the client run: /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh. This will prompt for a Nodename and Password, and whether you want to run scheduled backups. (If you are using a system with a startup script system significantly different to that used on Debian and Redhat systems, e.g. Gentoo, you may have to manually configure the scheduler to start).

For example:

 cd /tmp 
wget ftp://ftp.hfs.ox.ac.uk/repo/tar/tsm-client-6.2.5.0-4.tgz 
cd / 
su - 
tar -xhzf /tmp/tsm-client-6.2.5.0-4.tgz 
/opt/tivoli/tsm/client/ba/bin/HFSsetup.sh 

6.6.3. Upgrading the TSM client.

Save the files dsm.opt, dsm.sys, incl.excl and dsmsched.rc (if they exist) to a safe area.

Remove the /opt/tivoli directory tree.

Download the tar file and untar as for a fresh installation.

Copy back the files you saved earlier (dsm.opt, dsm.sys, etc) back to /opt/tivoli/tsm/client/ba/bin/

Run the /opt/tivoli/tsm/client/ba/bin/HFSsetup.sh script, which will upgrade the existing configuration.

If the update was successful, you can continue to use the TSM client as previously. Your scheduled backups should also continue to function as previously.

Up: Contents Previous: 5. Progress Checker Next: 7. Allowing non-root users to run the client