AIX operating systems

Installing the AIX client

You can install the AIX® 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

In IBM Spectrum Protect Version 8.1.9, 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 IBM Spectrum Protect, use SMIT to perform the following steps:
  1. Uninstall the 32-bit client (tivoli.tsm.client.ba).
  2. Uninstall any national language files that were previously installed.
  3. Uninstall the API (tivoli.tsm.client.api.32bit).
Next, use SMIT to install the following packages in the IBM Spectrum Protect V8.1.9 distribution libraries, in the following order:
  1. Install the 64-bit API (tivoli.tsm.client.api.64bit).
  2. Install the 64-bit client (tivoli.tsm.client.ba.64bit).

If you already have a 64-bit IBM Spectrum Protect V6.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 IBM Spectrum Protect installed (for example, V6.1, or V6.2) you must uninstall the client, language packs, and API. Then, install the new IBM Spectrum Protect API and client.

All of the packages that are needed to install the client are in the 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 client 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.ba.64bit
Installs the following 64-bit client files:
  • Backup-archive Java™ client (GUI)
  • Backup-archive web client
  • NAS backup client
tivoli.tsm.filepath_aix
Installs the file path kernel extension that is required for journal-based backup.
tivoli.tsm.client.jbb.64bit
Installs the journal-based backup component.
tivoli.tsm.client.webgui
Installs the files required to perform file-restore operations by using the web user interface.

Each package is installed in the following default installation directory:

  • The backup-archive, web client, and administrative client (dsmadmc) 64-bit files are installed in the /usr/tivoli/tsm/client/ba/bin64 directory.
  • The IBM Spectrum Protect 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.

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:

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 IBM Spectrum Protect image. From the AIX command line, enter:

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

A .toc file is created in that directory.

Procedure

  1. Log in as the root user.
  2. Mount the volume that you are installing from.
  3. From the AIX command line, type smitty install and press Enter.
  4. Select Install and Update Software and press Enter.
  5. Select Install and Update From ALL Available Software and press Enter.
  6. At the INPUT device/directory for software prompt, press the F4 key and specify the directory that contains the installation images, and press Enter.
  7. At the SOFTWARE to install prompt, press the F4 key. Select the IBM Spectrum Protect file sets you want to install by pressing the F7 key. Then, press the Enter key.
  8. 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.
  9. After the installation completes, press F10 to exit.

Results

When file sets are installed, they are automatically committed on the system. The previous version of backup-archive client software is replaced by the newly installed version.

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

  1. Make sure that the permissions of the installed files have not changed.
  2. Update the symbolic links for the installed files in the following directories:
    • The /usr/bin directory
    • The /usr/lib directory for IBM Spectrum Protect libraries
  3. Ensure that every user of the backup-archive client sets the DSM_DIR environment variable to the newly installed directory.

What to do next

After the installation completes, see Configure the IBM Spectrum Protect client for required and optional tasks to complete before you use the backup-archive client.

Note:
  • AIX workload partitions (WPAR) are supported as follows:
    • Supported in global environments
    • Supported with non-shared system WPARs
    • Supported with shared system WPARs (backup-archive client logs and configuration files must be defined to non-default locations)
    • No support for application WPARs
    • No support for image backup
    • No support for backup set restore from tape
  • On AIX Version 6.1, if you are using encrypted file systems (EFS) with the backup-archive client, 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 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 backup-archive 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