Linux operating systems

Installing the Tivoli Storage Manager Ubuntu Linux x86_64 client

You can install the IBM® Tivoli® Storage Manager Ubuntu Linux 64-bit client from the product DVD, or other installation media.

About this task

The following installation options are available in uncompressed packages on the DVD.
Table 1. Package names, contents, and default directory
Package Name Contents Default directory

gskcrypt64_8.0-50.40.linux.x86_64.deb

gskssl64_8.0-50.40.linux.x86_64.deb

64-bit Global Security Kit (GSKit) packages /usr/local/ibm/gsk8_64
tivsm-api64.amd64.deb 64-bit application programming interface (API), which contains the Tivoli Storage Manager API shared libraries and samples. /opt/tivoli/tsm/client/api/bin64
tivsm-ba.amd64.deb 64-bit Tivoli Storage Manager backup-archive client (command-line), administrative client (dsmadmc), the web client, and documentation. /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.

tivsm-apicit.amd64.deb

tivsm-bacit.amd64.deb

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, see "Estimating processor value units" in the Tivoli Storage Manager server documentation.

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

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

tivsm-filepath

tivsm-jbb.amd64.deb

Files needed to support journal-based backups.

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

Filepath for Ubuntu Linux is currently not distributed with the backup-archive client. To obtain the source code for filepath, follow the instructions that are described in step 6.

The tivsm-jbb.x86_64.deb package is installed in /opt/tivoli/tsm/client/ba/bin.

tivsm-bahdw.amd64.deb Provides support for snapshot incremental backup for NetAPP and N-Series file servers. /opt/tivoli/tsm/client/ba/bin/plugins
tivsm-msg.xx-xx.amd64.deb Additional languages and messages. /opt/tivoli/tsm/client/lang/xx-xx

Where xx-xx defines the language that is installed.

This installation procedure can be used to install new distributions or updates from a DVD or other media. If you download files from Passport Advantage® or other IBM website, the 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 and optional language packs. Install the packages in the order shown.

Procedure

To install the Tivoli Storage Manager Ubuntu Linux x86_64 client, complete the following steps.

  1. Mount the volume or DVD that you are installing from.
  2. Change to the directory where the installation packages are stored.
  3. Install the 64-bit GSKit packages.
    sudo dpkg -i gskcrypt64_8.0-50.40.linux.x86_64.deb gskssl64_8.0-50.40.linux.x86_64.deb
  4. Install the 64-bit 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 Tivoli Storage Manager API:
      sudo dpkg -i tivsm-api64.amd64.deb
    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.
      sudo dpkg -i tivsm-apicit.amd64.deb

    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, and the installation of additional languages.

  5. Install the backup-archive Java™ client, command-line client, administrative client, web client, and the documentation. Optionally install the Common Inventory Technology package that is necessary to support processor value unit (PVU) calculations.
    1. Install the backup-archive client components.
      sudo dpkg -i tivsm-ba.amd64.deb
    2. Optional: Install the Common Inventory Technology package that 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.
      sudo dpkg -i tivsm-bacit.amd64.deb
  6. Optional: Perform this step only if you plan to use use journal-based backups.
    1. Obtain and compile the source code for the filepath component, from IBM. Send an email requesting the source code to tsmosreq@us.ibm.com. Instructions to compile and install the source code are provided with the source code. The filepath kernel module is licensed pursuant to the terms of the GNU General Public License ("GPL").
    2. Install the journal-based backup package: dpkg -i tivsm-jbb.amd64.deb.
  7. Install the snapshot difference incremental backup support for NetApp and N-Series file servers by entering the following command:
    sudo dpkg -i tivsm-bahdw.amd64.deb
  8. Optional: The default language that is installed with the backup-archive client is American English. Use the general syntax that is shown in this step to install additional languages. Substitute the language identifier that is shown in the following table for the language_ID variable in the sample command:
    sudo dpkg -i tivsm-msg.language_ID.x86_64.deb
    Table 2. Language pack identifiers
    Language Language identifier
    Czech cs-cz
    French fr-fr
    German de-de
    Hungarian hu-hu
    Italian it-it
    Japanese ja-jp
    Korean ko-kr
    Polish pl-pl
    Portuguese pt-br
    Russian ru-ru
    Spanish es-es
    Traditional Chinese (EUC) zh-cn
    Traditional Chinese Big5 zh-tw