IBM Tivoli Storage Manager, Version 7.1

Installing the Tivoli Storage Manager AIX client

You can install the Tivoli® Storage Manager AIX® client from the product DVD, or other installation media.

In Tivoli Storage Manager 7.1, a 64-bit version of the AIX client is provided in the distribution libraries. You cannot upgrade a previously installed 32-bit AIX client to new the 64-bit AIX client. If you have a 32-bit client that is installed from a previous version of Tivoli Storage Manager, use SMIT to perform the following steps:

Uninstall the 32-bit client (tivoli.tsm.client.ba).
Uninstall any national language files that were previously installed.
Uninstall the API (tivoli.tsm.client.api.32bit).

Next, use SMIT to install the following packages in the Tivoli Storage Manager Version 7.1 distribution libraries, in the following order:

Install the 64-bit API (tivoli.tsm.client.api.64bit).
Install the national language files that you need.
Install the 64-bit client (tivoli.tsm.client.ba.64bit).

If you already have a 64-bit Tivoli Storage Manager Version 6.3 (or newer) client installed, you can upgrade the client instead of uninstalling it and reinstalling it.

If you have a 64-bit client from an earlier version of Tivoli Storage Manager installed (for example, Version 6.1, or 6.2) you must uninstall the client, language packs, and API. Then, then install the new Tivoli Storage Manager API, language packs, and client.

All of the packages that are needed to install the client are in the Tivoli Storage Manager AIX client package, and they overwrite any older runtime applications on your system during installation. The LibC (C Set ++) runtime library is required.

When you use the installp command to install this client, do not change the default field values for the following two choices:

"AUTOMATICALLY install requisite software?"
"OVERWRITE same or newer versions?"

Disabling or changing the values allows a lower level Tivoli Storage Manager component to install over a currently higher installed component. Under such circumstances, function calls between components at different levels might not be valid any longer.

Install the following packages. They are all provided on the installation media. You need an Extended Edition license to use the NAS client.

The following files are listed in order of dependency. For example, the API is dependent on the Global Security Kit (GSKit). When you install all of them using SMIT, you can select them (F7) in any order.

GSKit8.gskcrypt64.ppc.rte and GSKit8.gskssl64.ppc.rte

IBM® GSKit 64-bit (required by the 64-bit client API).

tivoli.tsm.client.api.64bit

Installs the 64-bit API.

tivoli.tsm.client.msg.lang

Installs the NL messages for API, where lang is the appropriate language code from Table 1.

tivoli.tsm.client.ba.64bit

Installs the following Tivoli Storage Manager 64-bit files:

Backup-archive Java™ client (GUI)
Backup-archive web client
Hardware backup client
Snapshot hardware backup client
NAS backup client

tivoli.tsm.filepath

Installs the file path kernel extension required for journal-based backup.

tivoli.tsm.client.jbb

Installs the Tivoli Storage Manager journal-based backup component.

The default installation directory where each package is installed is listed below:

The Tivoli Storage Manager backup-archive, web client, and administrative client (dsmadmc) 64-bit files are installed in the /usr/tivoli/tsm/client/ba/bin64 directory.
The Tivoli Storage Manager 64-bit API files are installed in the /usr/tivoli/tsm/client/api/bin64 directory.
The sample system-options file, dsm.sys.smp, is placed in the installation directory.

Table 1. AIX client: Language codes for installation packages
Language	Tivoli Storage Manager Language code
Simplified Chinese	ZH_CN
Traditional Chinese	ZH_TW
Czech	CS_CZ
French	FR_FR
German	DE_DE
Hungarian	HU_HU
Italian	IT_IT
Japanese	JA_JP
Korean	KO_KR
Polish	PL_PL
Brazilian Portuguese	PT_BR
Russian	RU_RU
Spanish	ES_ES

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 web site, 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.

If you are copying the client files into a local directory first, a .toc file is automatically created by the installp command. You can create a .toc file manually by running /usr/sbin/inutoc in the local directory to which you copied the Tivoli Storage Manager image. From the AIX command line, enter:

   /usr/sbin/inutoc /usr/sys/inst.images

A .toc file is created in that directory.

Log in as the root user.
Mount the volume or DVD that you are installing from.
From the AIX command line, type smitty install and press Enter.
Select Install and Update Software and press Enter.
Select Install and Update From ALL Available Software and press Enter.
At the INPUT device/directory for software prompt, press the F4 key and select the DVD device that contains the installation DVD, or specify the directory that contains the installation images, and press Enter.
At the SOFTWARE to install prompt, press the F4 key. Select the Tivoli Storage Manager file sets you want to install by pressing the F7 key. Then, press the Enter key.
On the Install and Update From ALL Available Software panel, press the F4 key to change any entry fields, or use the default fields. Press Enter twice to begin the installation.
After the installation completes, press F10 to exit.

Note:

When you install the clients in a locale other than an English locale, the corresponding local message file sets are required, in addition to the clients from the Install and Update From ALL Available Software panel. For example, when you install the Tivoli Storage Manager client in the ES_ES locale, the following message file set is also required:
```
   TSM Client Messages - Spanish            msg.ES_ES
```
When file sets are installed, the file sets are automatically committed on the system. The previous version of Tivoli Storage Manager software is replaced by the newly installed version.

The Tivoli Storage Manager files are installed in the /usr/tivoli/tsm/client/ba/bin64 directory. If you move the Tivoli Storage Manager files to another directory, you must perform the following steps:

Make sure that the permissions of the installed files have not changed.
Update the symbolic links for the installed files in the following directories:
- The /usr/bin directory
- The /usr/lib directory for Tivoli Storage Manager libraries
- The directory that contains symbolic links for each language package you install (for example, /usr/lib/nls/msg/en_US)
Ensure that every user of Tivoli Storage Manager sets the DSM_DIR environment variable to the newly installed directory.

After the installation completes, see Configure the Tivoli Storage Manager client for required and optional tasks to complete before you use Tivoli Storage Manager.

Note:

AIX workload partitions (WPAR) are supported as follows:
- supported in global environments
- supported with non-shared system WPARs
- supported with shared system WPARs (Tivoli Storage Manager logs and configuration files must be defined to non-default locations)
- no support for application WPARs
- no support for image backup
- no support for backupset restore from tape
On AIX Version 6.1, if you are using encrypted file systems (EFS) with Tivoli Storage Manager, and if the EFS user keystore password is different from the user login password, the EFS keystore is not automatically opened when you log on. If the EFS keystore is not open when you log on, the Tivoli Storage Manager client might not restore a non-EFS file into an EFS file system. You can prevent the EFS file system restore problem one of the following ways:
- Start the Tivoli Storage Manager client by using the efskeymgr -o command. For example: efskeymgr -o ./dsmj
- Synchronize the keystore password with the user login password by using the efskeymgr -n command. For example: efskeymgr -n

Feedback