Linux operating systems

Installing the Linux x86_64 client

You can install the Linux x86_64 backup-archive client from the product installation media.

Before you begin

  • You must be logged in as root to install the product.
  • If you have Tivoli® Storage Manager Version 6.2 (or an earlier version) installed, remove it (rpm -e) and any other dependent software programs before you install a newer version.
  • If you have Tivoli Storage Manager V6.3 (or later) installed, you can use the rpm upgrade option (rpm -U) or the rpm freshen option (rpm -F) to upgrade the existing software to a newer version. The rpm -U command can be used to install new packages or upgrade existing packages only if you did not previously install any language packages. The rpm -F command can update only packages that are already installed.
  • Stop any running client processes before you uninstall or upgrade the Tivoli Storage Manager API or backup-archive client.
  • If any language packages are installed, you must uninstall them before you install or upgrade the Tivoli Storage Manager API or backup-archive client.

About this task

The following installation options are available in uncompressed packages on the installation media.

Table 1. Package names, contents, and default directory
Package Name Contents Default directory


64-bit Global Security Kit (GSKit) packages /usr/local/ibm/gsk8
TIVsm-API64.x86_64.rpm Application programming interface (API), which contains the Tivoli Storage Manager API shared libraries and samples. /opt/tivoli/tsm/client/api/bin64
TIVsm-BA.x86_64.rpm Backup-archive client (command-line and GUI), administrative client (dsmadmc), and the web client. /opt/tivoli/tsm/client/ba/bin

This directory is considered to be the default installation directory for many backup-archive client files. The sample system-options file (dsm.sys.smp) is written to this directory. If the DSM_DIR environment variable is not set, the dsmc executable file, the resource files, and the dsm.sys file are stored in this directory.

If DSM_CONFIG is not set, the client user-options file must be in this directory.

If you do not define DSM_LOG, writes messages to the dsmerror.log and dsmsched.log files in the current working directory.



Optional. These files provide the Common Inventory Technology components that you can use to obtain information about the number of client and server devices that are connected to the system, and the utilization of processor value units (PVUs) by server devices. For more information about PVUs, see Estimating processor value units in the Tivoli Storage Manager server documentation.

APIcit is installed in /opt/tivoli/tsm/client/api/bin64/cit/

BAcit is installed in /opt/tivoli/tsm/client/ba/bin/cit/


where: version indicates the Tivoli Storage Manager version, and linuxOS indicates the Linux operating system that you are installing the filepath component on.



Files needed to support journal-based backups.

Filepath is installed in /opt/filepath

JBB is installed in /opt/tivoli/tsm/client/ba/bin

TIVsm_BAhdw.x86_64.rpm Provides support for snapshot incremental backup for NetAPP and N-Series file servers. /opt/tivoli/tsm/client/ba/bin/plugins

This installation procedure can be used to install new distributions or updates from downloaded installation media. The downloaded files that you use to install the client might be compressed. Depending on the package file format, either copy or extract the files to disk and use these instructions to install the components.

You can download the appropriate package file from one of the following websites:


To install the Linux x86_64 backup-archive client, complete the following steps:

  1. Mount the volume that you are installing from.
  2. Change to the directory where the installation packages are stored.
  3. Install the 64-bit GSKit packages. In this example, the "8.x.x.x" characters represent the GSKIT version on the installation media:
    rpm -U gskcrypt64-8.x.x.x.linux.x86_64.rpm gskssl64-8.x.x.x.linux.x86_64.rpm
  4. Install the Tivoli Storage Manager API, and optionally install the Common Inventory Technology package that is necessary to support processor value unit (PVU) calculations.
    1. Required: Install the API:
      rpm -i TIVsm-API64.x86_64.rpm
    2. Optional: Install the Common Inventory Technology package that is used by the API. This package depends on the API so it must be installed after the API package is installed.
      rpm -i TIVsm-APIcit.x86_64.rpm
    Tip: If you are upgrading the API and the Common Inventory Technology package was previously installed, you must upgrade both the API and Common Inventory Technology packages. For example, you can run the following command:
    rpm -U TIVsm-API64.x86_64.rpm TIVsm-APIcit.x86_64.rpm

    If you need only the API installed, you can stop here. The rest of the steps in this procedure describe how to install the backup-archive client components and an optional client package that is needed only if you want the client to send PVU metrics to the server. Also described in subsequent steps are the installation of the packages that are needed if you want to perform journal-based backups.

  5. Install the backup-archive client, and optionally install the Common Inventory Technology package that is necessary to support processor value unit (PVU) calculations.
    1. Install the backup-archive client components.
      rpm -i TIVsm-BA.x86_64.rpm
    2. Optional: Install the Common Inventory Technology package the client uses to send PVU metrics to the server. This package depends on the client package so it must be installed after the client package is installed.
      rpm -i TIVsm-BAcit.x86_64.rpm
  6. Optional: If you want to use journal-based backups, install the packages that are necessary to support the filepath component and journal-based backups. Install the filepath component first and ensure that you install the filepath package that is appropriate for the operating system on the client computer. Specify one of the following package names for the filepath package name:
    • TIVsm-filepath-version-rhel59.x86_64.rpm, for Red Hat Enterprise Linux 5.9.
    • TIVsm-filepath-version-rhel64.x86_64.rpm, for Red Hat Enterprise Linux 6.4
    • TIVsm-filepath-version-sles11sp2.x86_64.rpm, for SUSE Linux Enterprise Server 11, SP 2.

    Use the ls command to display the names of the filepath packages that are included in this release. Then, use rpm -i filepath_package_name.rpm to install the appropriate filepath package.

    If the filepath packages in the distribution do not apply to your Linux version, you must compile filepath from source code. Extract TIVsm-filepath-source.tar.gz and see the README file for compile and install instructions. The Linux Filepath kernel module is licensed pursuant to the terms of the GNU General Public License ("GPL").

  7. Install the snapshot difference incremental backup support for NetApp and N-Series file servers by entering the following command:
    rpm -i TIVsm-BAhdw.x86_64.rpm