Installing the Ubuntu Linux x86_64 client
You can install the Ubuntu Linux® 64-bit backup-archive client from the product installation media.
Before you begin
If you plan to install the client on the same system as the IBM Spectrum Protect server V8.1.2 or later level, ensure that you halt the IBM Spectrum Protect server before you install the client. This action will prevent the client installation process from forcing the system to reboot. After you install the client, you can restart the IBM Spectrum Protect server.
About this task
The following installation options are available in uncompressed packages on the installation media.
|Package Name||Contents||Default directory|
|64-bit Global Security Kit (GSKit) packages||/usr/local/ibm/gsk8|
|tivsm-api64.amd64.deb||Application programming interface (API), which contains the IBM Spectrum Protect API shared libraries and samples.||/opt/tivoli/tsm/client/api/bin64|
|tivsm-ba.amd64.deb||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 IBM Spectrum Protect server documentation.
APIcit is installed in /opt/tivoli/tsm/client/api/bin64/cit
BAcit is installed in /opt/tivoli/tsm/client/ba/bin/cit
|Files needed to support journal-based backups.||
The filepath and tivsm-jbb packages are only required if you plan to use journal-based backups.
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|
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.
To install the Ubuntu Linux x86_64 backup-archive client, complete the following steps.
- Mount the volume that you are installing from.
- Change to the directory where the installation packages are stored.
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
Install the IBM
Spectrum Protect API, and optionally
install the Common Inventory Technology package that is necessary to support processor value unit
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:
Install the API:
sudo dpkg -i tivsm-api64.amd64.deb
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
sudo dpkg -i tivsm-api64.amd64.deb 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.
- Required: Install the API:
Install the backup-archive client, and optionally install the Common Inventory Technology
package that is necessary to support processor value unit (PVU) calculations.
Install the backup-archive client components.
sudo dpkg -i tivsm-ba.amd64.deb
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
sudo dpkg -i tivsm-bacit.amd64.deb
- Install the backup-archive client components.
Complete this step only if you plan to use journal-based backups.
Extract tivsm-filepath-source.tar.gz and see the
README file for compile and install instructions.
The filepath kernel module is licensed pursuant to the terms of the GNU General Public License ("GPL").
Occasionally, build problems can occur due to the dynamic nature of the Linux kernel. If the source does not build correctly on your Linux distribution, send an email to email@example.com to request the latest source file. Include the version of the Linux distribution and the output of the uname -a command along with the version of the IBM Spectrum Protect client that you are installing.
Install the journal-based backup package:
dpkg -i tivsm-jbb.amd64.deb.
- Extract tivsm-filepath-source.tar.gz and see the README file for compile and install instructions.
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