Installation overview for the Tivoli Storage Manager for Space Management client for Linux x86_64 GPFS systems

Before you install the Tivoli® Storage Manager for Space Management client on Linux x86_64 General Parallel File System (GPFS™) systems, review both the general and the system-specific requirements. If you are installing the product for the first time, use the steps for an initial installation. Otherwise, use the steps for an upgrade.

Note:

HSM cluster installations are certified on IBM® Linux Cluster 1350. See the IBM Redbooks®: Linux Clustering with CSM and GPFS.
Also, see the recommendations that are provided with the IBM GPFS for Linux on x86_64 architecture.

When you install the Tivoli Storage Manager for Space Management client on Linux x86_64 GPFS file systems, the installation process makes the following changes:

Stops any space management daemons that are running.
Removes any statement from the /etc/inittab file that starts the dsmwatchd daemon at system startup.
Removes any statement from the /var/mmfs/etc/gpfsready script file that loads the other space management daemons at GPFS system startup.
Extracts the HSM modules.
Adds a statement to the /etc/inittab file that starts the dsmwatchd daemon at system startup.
Adds a statement to the /var/mmfs/etc/gpfsready script file that starts the other space management daemons at GPFS system startup.
Starts the space management daemons.

Table 1 lists the packages available on the installation media:

Table 1. Linux GPFS available packages
Package	Installs	Into this directory
TIVsm-API64.x86_64.rpm	The API for Linux x86_64 (64-bit only)	/opt/tivoli/tsm/client/api/bin64
TIVsm-BA.x86_64.rpm	The Tivoli Storage Manager backup-archive client (command line), the administrative client (command line), and the web backup-archive client (64-bit only)	/opt/tivoli/tsm/client/ba/bin
TIVsm-HSM.x86_64.rpm	The Tivoli Storage Manager for Space Management client for Linux x86_64 (64-bit only)	/opt/tivoli/tsm/client/hsm/bin
TIVsm-msg.`lang`.x86_64.rpm	The message package for language (where `lang` is the language code)	/opt/tivoli/tsm/client/`lang`

For an initial installation, complete the following steps:

If you want the GPFS policy engine to control automatic migration, you can disable the dsmmonitord and dsmscoutd automatic migration daemons. Disabling these daemons conserves system resources. To disable the automatic migration daemons, start this command in a shell:
```
export HSMINSTALLMODE=SCOUTFREE
```
For information about configuring GPFS integration with the Tivoli Storage Manager for Space Management client, see the Tivoli field guide TSM for Space Management for UNIX-GPFS Integration Part I: Policy-driven Threshold Migration at http://www.ibm.com/support/docview.wss?uid=swg27018848.
Edit the dsm.opt and dsm.sys files that are installed with the backup-archive client to configure the Tivoli Storage Manager for Space Management client.
Install the Tivoli Storage Manager for Space Management client on each HSM node. For AIX® clients, see Installing the Tivoli Storage Manager for Space Management client for AIX systems. For Linux clients, see Installing the Tivoli Storage Manager for Space Management client for Linux x86_64 GPFS systems.
Make sure that after installation, the dsmrecalld daemon is running on at least one node.
Enable the Data Management Application Programming Interface (DMAPI) for GPFS for all file systems to which you plan to add space management. Enable DMAPI only once for each file system.
1. Unmount all GPFS file systems on all nodes within the GPFS cluster to which you plan to add space management.
2. Activate DMAPI management for the GPFS file systems with the following command: mmchfs device -z yes.
  For information about GPFS commands and GPFS requirements for Tivoli Storage Manager, see the IBM Cluster Products information at Tivoli Storage Manager requirements.
3. Remount all GPFS file systems on all nodes within the GPFS cluster.
  The HSM daemons detect the initial state of each node and assign all nodes an instance number in relation to the GPFS cluster definition.
On the HSM owner nodes, add space management to each GPFS file system with the dsmmigfs command.
Use the dsmmigfs enablefailover command to enable failover of space management on the owner and source cluster nodes that participate in the failover group.