Linux operating systems

Installing the backup-archive client on Linux on Power Systems™ (Little Endian)

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

Before you begin

You must be logged in as root user to install the product.

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:

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

gskcrypt64-8.x.x.x.linux.ppcle.rpm
gskssl64-8.x.x.x.linux.ppcle.rpm

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

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

If you do not set the DSM_CONFIG environment variable, the client user-options file must be in this directory.

If you do not set the DSM_LOG environment variable, the backup-archive client writes messages to the dsmerror.log and dsmsched.log files in the current working directory.

TIVsm-filepath-version-linuxOS.ppc64le.rpm

Where: version indicates the IBM Spectrum Protect version, and linuxOS indicates the Linux operating system that you are installing the filepath component on.

TIVsm-filepath-source.tar.gz

TIVsm-JBB.ppc64le.rpm

Files that are needed for journal-based backups.

The filepath and TIVsm-JBB packages are only required if you plan to use journal-based backups.

Filepath is installed in /opt/filepath

The TIVsm-JBB.ppc64le.rpm package is installed in /opt/tivoli/tsm/client/ba/bin.

Procedure

  1. Mount the volume that you are installing the packages from.
  2. Change to the directory where the installation packages are stored.
  3. Install the 64-bit GSKit packages. In the following command example, the "8.x.x.x" characters represent the GSKit version:
    rpm -U gskcrypt64-8.x.x.x.linux.ppcle.rpm gskssl64-8.x.x.x.linux.ppcle.rpm
  4. Install the IBM Spectrum Protect API:
    rpm -ivh TIVsm-API64.ppc64le.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. Also described in subsequent steps are the installation of the packages that are needed if you want to run journal-based backups.

  1. Install the backup-archive client components:
    rpm -ivh TIVsm-BA.ppc64le.rpm
  2. Optional: If you want to use journal-based backups, install the packages that are needed for the filepath component and journal-based backups.
    1. 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-7.1.4-0-rhel7.ppc64le.rpm, for Red Hat Enterprise Linux 7.1.
      • TIVsm-filepath-7.1.4-0-sles12.ppc64le.rpm, for SUSE Linux Enterprise Server 12.

      Use the ls command to display the names of the filepath packages that are included in this release. Then, use rpm -ivh 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").

    2. Install the journal-based backup package:
      rpm -ivh TIVsm-JBB.ppc64le.rpm