IBM Tivoli Software IBM Tivoli Software

[ | | | ]


IBM Tivoli Storage Manager for Space Management for UNIX: User's Guide


Installing the HSM Client

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

Installation Procedure Page
Installing the HSM Client on AIX GPFS File Systems "Installing the HSM Client on AIX GPFS File Systems"
Installing the HSM Client on AIX JFS File Systems "Installing the HSM Client on AIX JFS File Systems"
Installing the HSM Client on HP-UX VxFS File Systems "Installing the HSM Client on HP-UX VxFS File Systems"
Installing the HSM Client on Linux86 GPFS File Systems "Installing the HSM Client on Linux86 GPFS File Systems"
Installing the HSM Client on Solaris VxFS File Systems "Installing the HSM Client on Solaris VxFS File Systems"

Moving Your Files to Another Directory

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:

  1. Verify that the permissions of the installed files did not change.
  2. Update the symbolic links for the installed files in the /usr/bin directory, and in the directory containing symbolic links for each language package that you install; for example, /usr/lib/nls/msg/en_US.
  3. Set the DSM_DIR environment variable to point to the newly-installed directory.

Installing the HSM Client on AIX GPFS File Systems

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:

dsmmigfs add
dsmmigfs remove
dsmmigfs update
dsmmigfs takeover
dsmmigfs rollback
dsmmigfs globalreactivate

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:

  1. Define which node within your GPFS nodeset will become the HSM session node (this is the node on which the GPFS file system(s) are HSM managed and all HSM daemons are running on).
  2. Define which node(s) within your GPFS nodeset will become HSM backup node(s) in case the HSM session node fails.
  3. Define which GPFS file systems will be HSM managed.
  4. Install Tivoli SpaceManager on the HSM session node (1). Make sure that after installation, the dsmrecalld daemon is up.
  5. Unmount all GPFS file systems on all nodes within the GPFS nodeset, that will be HSM managed.
  6. Activate DMAPI management for these GPFS file systems:
      mmchfs -z yes <device>
    
  7. Remount all GPFS file systems on all nodes within the GPFS nodeset.
  8. Define your Tivoli Storage Manager server and client configuration in the dsm.sys and dsm.opt files.
  9. Stop and restart the HSM daemons:
  10. On the HSM session node, add HSM management to at least one GPFS file system (dsmmigfs add <fs>). The HSM daemons will detect the initial state and assign this node the instance number one.
  11. Install Tivoli SpaceManager on the HSM backup node(s). If you plan to setup more than one HSM backup node, do the installation one after the other. The HSM backup node(s) will have subsequent instance numbers assigned.

    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:

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.

Environment Requirements

Before you install the HSM client, your workstation must meet these minimum requirements:

Hardware Requirements

Software Requirements

Operating System Requirements

Communication Methods

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)

Installation

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:

Install the HSM Client from the Command Line

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.

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.

  1. Mount your CD-ROM drive.
  2. Type smitty install and press Enter.
  3. Select Install and Update Software and press Enter.
  4. Select Install and Update From ALL Available Software and press Enter.
  5. At the INPUT device/directory for software prompt, press F4.
  6. Select the CD-ROM device that contains the installation CD-ROM (for example, /dev/cd0), or specify the directory that contains the installation images.
  7. Press Enter.
  8. At the SOFTWARE to install prompt, press F4.
  9. Scroll through the file sets and press F7 to select each Tivoli Storage Manager file set that you want to install.
  10. Press Enter. A minimum installation of HSM requires the following:
  11. Select any options that you want and press Enter to begin the installation. For more information about options, see "Selecting Your Options" or "Using Options".
  12. Unmount the CD-ROM drive.

Continue with "Registering Your Workstation with a Server".


Installing the HSM Client on AIX JFS File Systems

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.

Environment Requirements

Before you install the HSM client, your workstation must meet these minimum requirements:

Hardware Requirements

Software Requirements

Operating System Requirements

Communication Methods

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)

Installation

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:

Install the HSM Client from the Command Line

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.

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.

  1. Mount the CD-ROM drive.
  2. Type smitty install and press Enter.
  3. Select Install and Update Software and press Enter.
  4. Select Install and Update From ALL Available Software and press Enter.
  5. At the INPUT device/directory for software prompt, press F4.
  6. Select the CD-ROM device that contains the installation CD-ROM (for example, /dev/cd0), or specify the directory that contains the installation images.
  7. Press Enter.
  8. At the SOFTWARE to install prompt, press F4.
  9. Scroll through the file sets and press F7 to select each Tivoli Storage Manager file set that you want to install.
  10. Press Enter. A minimum installation of the HSM client requires the following:
  11. Select any options that you want and press Enter to begin the installation. For more information about options, see "Selecting Your Options" or "Using Options".
  12. Unmount the CD-ROM drive.

Obtain VFS and Group Numbers

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:

  1. Check the /etc/vfs file for the current use of vfs numbers.
  2. Release a number in the range of eight through fifteen.
  3. Start Tivoli Storage Manager installation again.

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".


|Installing the HSM Client on HP-UX VxFS File Systems

| | | | | | |

|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.

|Environment Requirements

| |

|Before you install the HSM client, your workstation must meet these minimum |requirements.

|Hardware Requirements

| | | | |

|Software Requirements

| | |

|Operating System Requirements

| | |

|Communication Methods

| |

|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)

|Installation

| | | |

|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
|Note:
'pwd' may be used instead of the absolute name of the current |directory. |

|Continue with "Registering Your Workstation with a Server".


|Installing the HSM Client on Linux86 GPFS File Systems

| | | | | |

|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.

|Environment Requirements

| | |

|Before you install the HSM client, your workstation must meet these minimum |requirements:

|Hardware Requirements

| | | | | | |

|Software Requirements

| | | | | |

|Operating System Requirements

| | |

|Communication Methods

| |

|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)

|Installation

|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. |

  1. |Log in as the root user and mount the CD-ROM to the /cdrom |directory.
  2. |Enter the following directory path where the installation packages reside |on the CD:
    |/cdrom/tsmcli/linux86
  3. |Install the Tivoli Storage Manager clients in the order that is presented |in Table 4. During installation, these packages are installed in |unique directories.
  4. |Respond Yes (y) to the questions.
  5. |Restart your system when you complete the installation. |

|

|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



Administrative client



Documentation

rpm -i TIVsm-BA.i386.rpm
To 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".


Installing the HSM Client on Solaris VxFS File Systems

Note:
Install HSM on Solaris VxFS file systems only. Do not attempt to install HSM on other Solaris file systems.

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

Environment Requirements

Before you install the HSM client, your workstation must meet these minimum requirements.

Hardware Requirements

Software Requirements

Operating System Requirements

Communication Methods

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)

Installation

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:

  1. Log in as the root user and mount the CD-ROM to the /cdrom directory.
  2. Install the Tivoli Storage Manager clients in the order that is presented in Table 5. During installation, these packages are installed in unique directories.
  3. Respond Yes (y) to the questions.
  4. Restart your system when you complete the installation.

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



Administrative 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".


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.

Use Closed Registration

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".

Use Open Registration

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:

Note:
Your Tivoli Storage Manager administrator can change these defaults at any time.

Continue with "Starting the HSM Client".


Changing your Password

Note:
This task is optional.

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:

  1. Click Utilities on the menu bar.
  2. Click Change Password. The Change Password window displays.
  3. Enter your current Tivoli Storage Manager password in the Current password field.
  4. Enter a new password in the New password field.
  5. Enter the new password again in the Re-enter new password field.
  6. Click OK. The Tivoli Storage Manager client updates your password for the server that your client node contacts for space management services.
Note:
To change your Tivoli Storage Manager password from the command line, enter:
   dsmsetpw oldpw newpw

Replace oldpw newpw with your old and new passwords.


Starting the HSM Client

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".


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]