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.12, a 64-bit version of the AIX client is provided in the distribution libraries.
- 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).
- Install the 64-bit API (tivoli.tsm.client.api.64bit).
- 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.
- AUTOMATICALLY install requisite software?
- OVERWRITE same or newer versions?
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.
- Download the client package from Passport Advantage or Fix Central.
- For the latest information, updates, and maintenance fixes, go to the IBM Support Portal.
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
- Log in as the root user.
- Mount the volume 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 specify the directory that contains the installation images, and press Enter.
- 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.
- 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.
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:
- 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 IBM Spectrum Protect libraries
- 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.
- 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