Installing the Tivoli Storage Manager AIX Client

Download the Tivoli Storage Manager AIX Client here: ftp://ftp.software.ibm.com/storage/tivoli-storagemanagement/maintenance/client/v6r3/AIX/ You can install the Tivoli Storage Manager AIX client on both 32-bit clients and 64-bit clients. However, only one client can be installed at a time. If you install both the 32-bit and 64-bit clients at the same time, you receive an error message. If you are moving from a 32-bit client to a 64-bit client, first remove the 32-bit client using SMIT (tivoli.tsm.client.ba). Then install the 64-bit client (tivoli.tsm.client.ba.64bit). If you use the 64-bit client, you must also install the 64-bit version of the API (tivoli.tsm.client.api.64bit). The 32-bit API (tivoli.tsm.client.api.32bit) is installed at the same time, and can coexist with the 64-bit API. If the 64-bit client is installed but you want to use the 32-bit client instead, you must remove the 64-bit client. Use SMIT to remove the 64-bit client (tivoli.tsm.client.ba.64bit), and then install the 32-bit client. You do not need to uninstall the 64-bit API. If you are upgrading from a previous version of the Tivoli Storage Manager AIX client, use SMIT to remove any national language filesets that might be installed, and install the national language filesets provided with Tivoli Storage Manager 6.2. You cannot perform an upgrade install from the Tivoli Storage Manager Version 5.5 or earlier client to the Tivoli Storage Manager Version 6.2 64bit client. You must remove the older 32-bit client before installing the Tivoli Storage Manager Version 6.2 64-bit client. All of the needed packages are included in the Tivoli Storage Manager AIX client package, and they overwrite any older runtime applications on your system during installation. LibC (C Set ++) runtime is required.

When using 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 allow 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. You can install only one of these clients: tivoli.tsm.client.ba (32-bit client, includes the HSM JFS2 client) tivoli.tsm.client.ba.gpfs (32-bit client, required when using the GPFS HSM client) tivoli.tsm.client.ba64 (64-bit client; no HSM) You can install these APIs: tivoli.tsm.client.api.32bit tivoli.tsm.client.api.64bit

Note: All of these packages are available on the installation media. HSM installation information is in the Tivoli Storage Manager for Space Management for UNIX and Linux User's Guide. You need an HSM license to install and use those file sets. You need an Extended Edition license to use the NAS client.

AIX client tivoli.tsm.client.ba Installs the following Tivoli Storage Manager 32-bit files: Backup-archive base files Backup-archive common files Backup-archive Web client Image backup client NAS backup client tivoli.tsm.client.ba64 Installs the following Tivoli Storage Manager 64-bit files:

Backup-archive base files Backup-archive common files Backup-archive Web client Image backup client tivoli.tsm.client.ba.gpfs Installs the following Tivoli Storage Manager 32-bit files: Backup-archive base files Backup-archive common files Backup-archive Web client Image backup client tivoli.tsm.client.hsm.gpfs Installs the Tivoli Storage Manager Hierarchical Storage Management GPFS client. tivoli.tsm.client.hsm Installs the Tivoli Storage Manager Hierarchical Storage Management JFS2 client. tivoli.tsm.client.jbb Installs the Tivoli Storage Manager journal-based backup component. tivoli.tsm.client.api.32bit Installs the 32-bit 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.filepath_aix Installs the file path kernel extension required for journal-based backup. GSKit8.gskcrypt32.ppc.rte and GSKit8.gskssl32.ppc.rte SSL Toolkit 32-bit (required by the backup-archive client and its components). GSKit8.gskcrypt64.ppc.rte and GSKit8.gskssl64.ppc.rte SSL Toolkit 64-bit (required by the 64-bit client API).

Default installation directories Here are the default directories where some files are stored as part of the client installation:

The Tivoli Storage Manager backup-archive, Web client, and administrative client (dsmadmc) files are installed in the /usr/tivoli/tsm/client/ba/bin directory. 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 API files are installed in the /usr/tivoli/tsm/client/api/bin directory. The Tivoli Storage Manager API 64 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 Simplified Chinese Traditional Chinese Czech French German Hungarian Italian Japanese Korean Polish Brazilian Portuguese Russian Spanish Tivoli Storage Manager Language code ZH_CN ZH_TW CS_CZ FR_FR DE_DE HU_HU IT_IT JA_JP KO_KR PL_PL PT_BR RU_RU ES_ES

The Tivoli Storage Manager files are installed in the /usr/tivoli/tsm/client/ba/bin directory. If you move the Tivoli Storage Manager files to another directory, you must perform the following steps: Make sure 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 perform before using Tivoli Storage Manager. After successfully installing the Tivoli Storage Manager client, you must configure the client before performing any operations. If you are upgrading your Tivoli Storage Manager client, it is unnecessary to reconfigure the scheduler, Web client, or other configuration settings. If the dsm.opt and dsm.sys files used by the previous client installation are available in the default installation directory or the directory or file pointed to by the DSM_CONFIG and DSM_DIR environment variables, Tivoli Storage Manager accesses these files for configuration information. The client system-options file is an editable file that identifies the server and communication method, and provides the configuration for backup, archiving, hierarchical storage management, and scheduling. Creating and modifying the client system-options file (dsm.sys) is a required root user or authorized user task.

Here is a sample dsm.sys file: SErvername COMMmethod TCPPort TCPServeraddress Nodename Passwordaccess Errorlogretention Schedlogretention ManagedServices Inclexcl TSMServerName TCPip PortAddress tsmserver.berkeley.edu mynode generate 10 D 10 D Webclient Schedule /home/mydir/TSMmc.inc

IMPORTANT NOTE: You will need receive and email from the Storage and Backup Group with TSM Server Name, Port, TCP Server Address and your node name. You will have to replace the above entries with this information.

After the dsm.sys file has been updated, start the client using the following command:

dsmc

You will then be prompted for your tsm password. Enter the password supplied by the Storage and Backup Group. To exit, enter quit.

Configuring the client scheduler

This task guides you through the steps to configure the client scheduler. Your Tivoli Storage Manager administrator can schedule Tivoli Storage Manager to perform tasks automatically. For example, you can automatically back up files at the end of each day or archive some of your files every Friday. This procedure, known as central scheduling, is a cooperative effort between the server and your client node. Your administrator associates clients with one or more schedules that are part of the policy domain maintained in the server database. The Tivoli Storage Manager administrator defines central scheduling on the server and you start the client scheduler on your workstation. Once you start the client scheduler, further intervention is not necessary. With client scheduling, you can perform the following tasks: Display information about available schedules. Display information about work that the schedule has completed. Add these lines to /etc/inittab: itsm::once:/usr/bin/dsmc schedule >/dev/null 2>&1 #TSM scheduler itsm2::once:/usr/bin/dsmcad >/dev/null 2>&1 #TSM web client

This will start the scheduler. The installation is now complete.

Please contact the Storage and Backup Group if you have any questions or problems during the installation process.