Linux operating systems

Installing the API on Linux on Power Systems (Big Endian)

You can install the IBM Spectrum Protect API from the product installation media.

Before you begin

  • You must be logged in as root user to install the product.
  • If you have IBM Spectrum Protect 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 IBM Spectrum Protect V6.3 (or newer) 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; rpm -F can update only packages that are already installed.
  • Stop any running client processes before you uninstall or upgrade the IBM Spectrum Protect API or backup-archive client.
  • If you are running a V7.1.2 or earlier client, you must uninstall any language packages before you proceed with the upgrade.

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.ppc.rpm
gskssl64-8.x.x.x.linux.ppc.rpm
 64-bit Global Security Kit (GSKit) packages /usr/local/ibm/gsk8
TIVsm-API64.ppc64.rpm Application programming interface (API), which contains the IBM Spectrum Protect API shared libraries and samples. /opt/tivoli/tsm/client/api/bin64

TIVsm-APIcit.ppc64.rpm

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 IBM Spectrum Protect server documentation.

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

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:
Before installation, you must first check the signature of the client package as follows:
  1. Download the generated gpk key RPM-GPG-KEY-ibmpkg from the download sites that also contain the client packages.
  2. Import the generated gpk key by entering the following command:
    rpm --import RPM-GPG-KEY-ibmpkg
  3. Verify the client package by entering the following command:
    rpm -K <client_package>.rpm
    where <client_package> is the name of an rpm package that is listed in Table 1 - Package names, contents, and default directory.

Procedure

  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: 
    rpm -U gskcrypt64-8.x.x.x.linux.ppc.rpm gskssl64-8.x.x.x.linux.ppc.rpm
  4. Install the IBM Spectrum Protect API, and optionally install the Common Inventory Technology package that is needed to support processor value unit (PVU) calculations.
    1. Required: Install the API: 
      rpm -i TIVsm-API64.ppc64.rpm
    2. Optional: Install the Common Inventory Technology package that is used by the API. This package is dependent on the API so it must be installed after the API package is installed. 
      rpm -i TIVsm-APIcit.ppc64.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.ppc64.rpm TIVsm-APIcit.ppc64.rpm