![]() |
![]() |
[ | | | ]
Attention: Install and set up the IBM Tivoli Storage Manager for UNIX Backup-Archive Client before you install the HSM client. Both clients share common code and they use the same options files, communication protocols, node registration, and server file spaces.
This chapter provides installation and setup tasks for the HSM client. You must have root user authority to install, set up, and use the HSM client on your workstation.
You can add space management to the following operating systems:
The HSM client must communicate with a Tivoli Storage Manager server.
Additional components for each operating system include a command-line help and a graphical user interface help.
Install the HSM client on your workstation and register it as a client node with a IBM Tivoli Storage Manager server. Assign this node to a policy domain containing one or more management classes that are configured to support space management services. When you complete the installation, continue with "Selecting Your Options" to modify your dsm.sys file and your dsm.opt file for space management. Both files are located in the /usr/tivoli/tsm/client/ba/bin directory.
Attention: Before you reinstall the HSM client, stop all activity and do not access any files on file systems to which you added space management. The install process will fail otherwise.
Table 3 displays the page location for you to go to begin
installation of the HSM client.
Table 3. HSM Client Installation Procedures
On AIX, the backup-archive client and the common files are installed in the /usr/tivoli/tsm/client/ba/bin directory. The HSM client files are installed in the /usr/tivoli/tsm/client/hsm/bin directory.
On Solaris, HP-UX, and Linux86, the backup-archive client and the common files are installed in the /opt/tivoli/tsm/client/ba/bin directory. The HSM client files are installed in the /opt/tivoli/tsm/client/hsm/bin directory.
If you move HSM files to another directory, perform the following steps:
Attention: The HSM client for AIX GPFS and the HSM client for AIX JFS are exclusive of each other. During installation, the program checks for the existence of the other. If the program detects either client, installation stops.
If HSM is globally deactivated on a node (dsmmigfs globaldeactivate), it is reset to active state, if one of the following commands are performed:
The HSM client for AIX GPFS supports RS6000/SP systems (PSSP cluster) and IBM Regatta pSeries (AIX HACMP/ES cluster).
Attention: For an initial installation, follow these steps exactly in this order:
mmchfs -z yes <device>
Note: Because the failover technique is enabled by default after installation, the dsmwatchd will automatically restart the HSM daemons.
Note: The HSM daemon dsmwatchd needs to be up and running on the HSM backup node(s). The other HSM daemons are started automatically if the HSM session node fails.
When you install the HSM client for GPFS on a PSSP or AIX cluster file system, the install process:
SDR | Files |
---|---|
Files |
dsm.opt.x dsm.sys.x dsmmigfstab.x Where x is the node-set ID |
Class | DSMLock |
Class Objects |
dsm.opt.x dsm.sys.x dsmmigfstab.x dsmmigfs.x Where x is the node-set ID |
If the file does not exist, the install process creates the following HSM-specific files or objects for each GPFS node set in the Tivoli Storage Manager client internal SDR for an AIX cluster:
The sections that follow describe client environment requirements and installation instructions for the HSM client. For current installation and configuration information for the HSM client, refer to the readme file that is shipped on the product installation media.
Before you install the HSM client, your workstation must meet these minimum requirements:
This table displays what you must install to communicate with your
server.
To use this communication method | To connect to these servers | Install this on your workstation |
---|---|---|
TCP/IP | AIX, HP-UX, Linux, OS/390, OS/400 PASE, Solaris, VM, Windows, z/OS | TCP/IP (Standard with supported AIX/6000 platforms) |
Shared memory | AIX | TCP/IP (Standard with supported AIX platforms) |
Attention: The GPFS-enhanced Tivoli Storage Manager backup-archive client (tivoli.tsm.client.ba.gpfs.aix51.32bit) is a prerequisite for the HSM client on AIX GPFS file systems. You must install this file set. The backup-archive client is enhanced to handle any file systems that the HSM client handles for AIX GPFS.
Before you install the HSM client, verify that there are no HSM activities processing on your managed file systems.
The following packages are available on the installation media in the
/usr/sys/inst.images directory:
Package | Installs | Into |
---|---|---|
tivoli.tsm.client.ba.gpfs.aix51.32bit | The backup-archive client for AIX 5.1 32bit and AIX 5.1 32bit | The /usr/tivoli/tsm/client/ba/bin directory |
tivoli.tsm.client.hsm.gpfs.aix51.32bit | The HSM client for AIX 5.1 32bit | The /usr/tivoli/tsm/client/hsm/bin directory |
The /usr/tivoli/tsm/client/hsm/bin directory is one of the base directories into which the HSM client product is installed. Any files that you place in this directory might be deleted during installation. Do not place the following files into this directory:
If you are not installing the HSM client from a CD-ROM, enter the following command from the AIX command line:
/usr/sbin/inutoc <dir>
Where <dir> is the directory in which the HSM image resides. A .toc file is created in this directory. Continue with step 2 located in Install the HSM Client from the CD-ROM.
If you are installing the HSM client from a CD-ROM, insert the CD-ROM into the drive. Then, follow the steps below.
Continue with "Registering Your Workstation with a Server".
Attention: The HSM client for AIX JFS and the HSM client for AIX GPFS are exclusive of each other. During installation, the program checks for the existence of the other. If the program detects either client, installation stops.
When you install the HSM client on an AIX JFS file system, the install process:
See Appendix A, "Using the Installfsm Program" for more information about the installfsm program.
The sections that follow describe client environment requirements and installation instructions for the HSM client. For current installation and configuration information for the HSM client, refer to the readme file that is shipped on the product installation media.
Before you install the HSM client, your workstation must meet these minimum requirements:
This table displays what you must install to communicate with your Tivoli
Storage Manager server.
To use this communication method | To connect to these Tivoli Storage Manager servers | Install this on your workstation |
---|---|---|
TCP/IP | AIX, HP-UX, Linux, OS/390, OS/400 PASE, Solaris, VM, Windows, z/OS | TCP/IP (Standard with supported AIX/6000 platforms) |
Shared memory | AIX | TCP/IP (Standard with supported AIX platforms) |
Attention: Install and set up the Tivoli Storage Manager for UNIX Backup-Archive Client before you install the HSM client. Some common files, such as dsm.sys and dsm.opt, are installed in the /usr/tivoli/tsm/client/ba/bin directory.
The following packages are available on the installation media in the
/usr/sys/inst.images directory:
Package | Installs | Into |
---|---|---|
tivoli.tsm.client.ba.aix32bit | The backup-archive client for AIX JFS 32bit | The /usr/tivoli/tsm/client/ba/bin directory |
tivoli.tsm.client.hsm.jfs.aix32bit | The HSM client for AIX JFS 32bit | The /usr/tivoli/tsm/client/hsm/bin directory |
tivoli.tsm.client.ba.aix64bit | The backup-archive client for AIX JFS 64bit | The /usr/tivoli/tsm/client/ba/bin directory |
tivoli.tsm.client.hsm.jfs.aix64bit | The HSM client for AIX JFS 64bit | The /usr/tivoli/tsm/client/hsm/bin directory |
The /usr/tivoli/tsm/client/hsm/bin directory is one of the base directories into which the HSM client product is installed. Any files that you place in this directory might be deleted during installation. Do not place the following files into this directory:
If you are not installing the HSM client from a CD-ROM, enter the following command from the AIX command line:
/usr/sbin/inutoc <dir>
Where <dir> is the directory in which the HSM image resides. A .toc file is created in this directory. Continue with step 2 located in Install the HSM Client from the CD-ROM.
If you are installing the HSM client from a CD-ROM, insert the CD-ROM into the drive and continue with the steps below.
When you install HSM on an AIX JFS file system, the HSM client obtains a virtual file system (vfs) number. Because numbers zero through seven are reserved, the program attempts to obtain a vfs number in the range of eight through fifteen. The HSM client begins with the number fifteen and descends in that range to locate an unused number. If a number is not available, an error message displays. You must:
The HSM client also obtains group numbers for HSM execution modes. The program selects an unused range of group numbers beginning with the largest possible group number and descending to the smallest possible group number. The range is xxxxxx00 through xxxxxx7F.
Continue with "Registering Your Workstation with a Server".
|The sections that follow describe client environment requirements and |installation instructions for the HSM client on HP-UX file systems. For |current installation and configuration information for the HSM client, refer |to the readme file that is shipped on the product installation media.
|Before you install the HSM client, your workstation must meet these minimum |requirements.
|This table displays what you must install to communicate with your Tivoli
|Storage Manager server.
|
To use this communication method | To connect to these Tivoli Storage Manager servers | Install this on your workstation |
---|---|---|
TCP/IP | AIX, HP-UX, Linux, OS/390, OS/400 PASE, Solaris, VM, Windows, z/OS | TCP/IP (Standard with HP-UX) |
Shared memory | HP-UX | TCP/IP (Standard with HP-UX) |
|Attention: Install and set up the IBM Tivoli Storage Manager |for UNIX Backup-Archive Client before you install the HSM |client. Install HSM on HP-UX VxFS file systems only. |Do not attempt to install HSM on other HP-UX file systems.
|The Veritas file system requires that the kernel extension (thsmdmapi) is |loaded before you can use the HSM client. This kernel extension loads |automatically during startup.
|To install from the CD-ROM, log in as the root user, mount the CD-ROM to |/cdrom, and change directory to tsmcli/hp11. If you downloaded from |ftp, go to the directory where the installable image is located. Enter |the following command to install the IBM Tivoli Storage Manager for UNIX |Backup-Archive Client:
| /usr/sbin/swinstall -x mount_all_filesystems=false -v -s 'pwd'/ | TIVsmC TIVsm
|Enter the following command to install the HSM client:
|/usr/sbin/swinstall -x mount_all_filesystems=false -v -s 'pwd'/ TIVsmChsm |TIVsm.CLIENT_HSM
|Continue with "Registering Your Workstation with a Server".
|For an initial installation on Linux86 cluster systems (IBM @server Cluster |1350), install the HSM client on only one node and enable at least one GPFS |file system for HSM on that node (dsmmigfs add ). |The HSM daemons will detect the initial state and assign this node the |instance number one. The first HSM-managed file system must be defined |on this node. Then, select other nodes if you want to install the HSM |client for failover, or to manage other GPFS file systems.
|Install Tivoli Storage Manager on all cluster nodes that are part of a GPFS |node set and that will become a DMAPI session node in the event of |failover.
|When you install the HSM client for GPFS on a Linux86 cluster file system, |the install process: |
|The sections that follow describe client environment requirements and |installation instructions for the HSM client. For current installation |and configuration information for the HSM client, refer to the readme file |that is shipped on the product installation media.
|Before you install the HSM client, your workstation must meet these minimum |requirements:
|This table displays what you must install to communicate with your
|server.
|
To use this communication method | To connect to these servers | Install this on your workstation |
---|---|---|
TCP/IP | AIX, HP-UX, Linux, OS/390, OS/400 PASE, Solaris, VM, Windows, z/OS | TCP/IP (Standard with Linux) |
|Attention: The GPFS-enhanced Tivoli Storage Manager |backup-archive client (TIVsm-BA.i386.rpm) is a prerequisite for |the HSM client on Linux86 GPFS file systems. You must install this file |set. The backup-archive client is enhanced to handle any file systems |that the HSM client handles for Linux86 GPFS.
|Before you install the HSM client, verify that there are no HSM activities |processing on your managed file systems.
|The following packages are available on the installation media in the
|/opt/sys/inst.images directory:
|
Package | Installs | Into |
---|---|---|
TIVsm-BA.i386.rpm | The Tivoli Storage Manager backup-archive client (command-line and native GUI), the administrative client (command-line), the Web backup-archive client, and the Tivoli Storage Manager documentation. | The /opt/tivoli/tsm/client/ba/bin directory |
TIVsm-HSM.i386.rpm | The HSM client for Linux86 | The /opt/tivoli/tsm/client/hsm/bin directory |
|The /opt/tivoli/tsm/client/hsm/bin directory is one of the base |directories into which the HSM client product is installed. Any files |that you place in this directory might be deleted during installation. |Do not place the following files into this directory: |
|If you are installing the HSM client from a CD-ROM, insert the CD-ROM into |the drive. Then, follow the steps below. |
|/cdrom/tsmcli/linux86
|Table 4. Package Names and Descriptions
To Install This | Enter This Command |
---|---|
API |
rpm -i TIVsm-API.i386.rpm Installs the API files in the/opt/tivoli/tsm/client/api/bin directory. |
Backup-archive client (CLI and GUI) Web client
|
rpm -i TIVsm-BA.i386.rpmTo circumvent the dependence check, use the --nodeps option. Please be aware to check the dependencies manually: First: rpm -i --nodeps TIVsm-API.i386.rpm Then: rpm -i --nodeps TIVsm-BA.i386.rpm Installs the backup-archive client (command-line and GUI) and the Web client in the /opt/tivoli/tsm/client/ba/bin directory. Installs the the administrative client (command-line) in the /opt/tivoli/tsm/client/admin/bin directory. Installs the Tivoli Storage Manager documentation files in the /opt/tivoli/tsm/client/books directory. |
HSM client |
rpm -i TIVsm-HSM.i386.rpm Installs the HSM client files in the /opt/tivoli/tsm/client/hsm/bin directory. |
|Continue with "Registering Your Workstation with a Server".
The sections that follow describe client environment requirements and installation instructions for the HSM client on Solaris file systems. For current installation and configuration information for the HSM client, refer to the readme file that is shipped on the product installation media.
If you want to display the Tivoli Storage Manager help browser menus in your local language, the NLSPATH environment variable in the /etc/profile file must contain the following path:
/usr/dt/lib/nls/msg/%L/%N.cat
To enable the CDE help browser to use non-English fonts and messages, modify the NLSPATH environment variable:
NLSPATH=/usr/dt/lib/nls/msg/%L/%N.cat:$NLSPATH export NLSPATH
Before you install the HSM client, your workstation must meet these minimum requirements.
This table displays what you must install to communicate with your Tivoli
Storage Manager server.
To use this communication method | To connect to these Tivoli Storage Manager servers | Install this on your workstation |
---|---|---|
TCP/IP | AIX, HP-UX, Linux, OS/390, OS/400 PASE, Solaris, VM, Windows, z/OS | Standard with Solaris |
Shared memory | Solaris | TCP/IP (Standard with Solaris) |
The Solaris file system requires that the kernel extension (adsmhsm) is loaded before you can use the HSM client. This kernel extension loads automatically during startup. Once the kernel extension is loaded, you cannot unload it. If you plan to install a new version of the HSM client, remove the HSM client and restart your system before you install a new version. If you do not plan to reinstall the HSM client, remove the HSM client and restart your system to unload the kernel extension.
Follow these steps to install the HSM client:
Table 5. Package Names and Descriptions
To Install This | Enter This Command |
---|---|
API |
pkgadd -d /cdrom/tsmcli/solaris/TIVsmCapi.pkg TIVsmCapi Installs the API files in the/opt/tivoli/tsm/client/api/bin directory. |
Backup-archive client (CLI and GUI) Web client
|
pkgadd -d /cdrom/tsmcli/solaris/TIVsmCba.pkg TIVsmCba Installs the backup-archive client and web client files in the /opt/tivoli/tsm/client/ba/bin directory. Installs the administrative client in the /opt/tivoli/tsm/client/admin/bin directory. |
HSM client |
pkgadd -d /cdrom/tsmcli/solaris/TIVsmChsm.pkg TIVsmChsm Installs the HSM client files in the /opt/tivoli/tsm/client/hsm/bin directory. |
Client documentation |
pkgadd -d /cdrom/tsmcli/solaris/TIVsmCdoc.pkg TIVsmCdoc Installs the documentation files in the /opt/tivoli/tsm/client/books directory. |
Continue with "Registering Your Workstation with a Server".
Before you request services from a Tivoli Storage Manager server, register your workstation as a single client node with that server. If you plan to use a web client with an enterprise management server, ensure that you are assigned an administrative user ID with system privilege, policy privilege, client access, or client-owner authority. Your Tivoli Storage Manager administrator assigns registration as either closed or open.
With closed registration, your Tivoli Storage Manager administrator must register your workstation as a client node with the server. If your enterprise uses closed registration, provide the following information to your administrator:
Your administrator defines:
Continue with "Starting the HSM Client".
Open registration permits the root user to register your workstation as a client node with the server. Your workstation must be registered before anyone can use Tivoli Storage Manager on that node.
To start a session with the graphical user interface, enter the dsm command. To start a session with the command-line interface, enter the dsmc command.
The first time you start a session, you are prompted for information to register your workstation with a server that is identified in your dsm.sys file. Supply the following information:
To register your workstation with additional servers, enter the dsm command or the dsmc command with the servername option for each server. For example:
dsm -servername=dsmserv
Where dsmserv is the name of a server that you identified in your dsm.sys file. You are prompted for information to register your workstation with the server that you specify.
When you use open registration:
Continue with "Starting the HSM Client".
If you installed the HSM client on your client node and you require a Tivoli Storage Manager password, set the passwordaccess option to generate in your dsm.sys file. Set the mailprog option in your dsm.sys file to send you the password each time it generates a new one. Tivoli Storage Manager encrypts and stores your password locally, and automatically generates a new password for your client node each time it expires. You are not prompted for a Tivoli Storage Manager password.
The backup-archive client and the HSM client use the same password when both clients contact the same Tivoli Storage Manager server. One password is required for each Tivoli Storage Manager server that your client node contacts for services.
If you specify a migration server on the migrateserver option in your dsm.sys file, the password that you set applies to the migration server.
If you specify a default server on the defaultserver option in your dsm.sys file and you do not specify a migration server on the migrateserver option, the password that you set applies to the default server.
If you do not specify either a migration server or a default server on either the migrateserver option or the defaultserver option, the password that you set applies to the named server in the first stanza of your dsm.sys file.
To change your password from the GUI:
dsmsetpw oldpw newpw
Replace oldpw newpw with your old and new passwords.
Attention: Before you can start the graphical user interface (GUI), CDE must be installed and the X Window System must be running. It is not necessary for CDE to be running when you start the graphical user interface. You can use hierarchical storage management commands rather than the GUI to perform most space management tasks. The GUI is only available for root users. It is not available for HSM on AIX GPFS or HP-UX VxFS.
To start the GUI and open the Tivoli Storage Manager window, double-click the icon. If the Tivoli Storage Manager icon does not display, enter dsmhsm. A window displays from which you can select a task.
Continue with "Selecting Your Options".