Configuring the Backup System and TSM

Perform the following steps to configure TSM and the AFS Backup System for interoperation.

• Become the local superuser root, if you are not already.

  % su root Password: root_password

• Install version 3.7.1 of the TSM client API on the local disk of the Tape Coordinator machine. If you do not already have the API, you can use the following instructions to download it using the UNIX File Transfer Protocol (ftp).

  • Verify that there is enough free space on the local disk to accommodate the API package:

    • On AIX systems, 4 MB on the disk that houses the /usr/tivoli directory

    • On Solaris systems, 13 MB on the disk that houses the /opt/tivoli directory

  • Connect to the ftp server called ftp.software.ibm.com, logging in as anonymous and providing your electronic mail address as the password.

  • Switch to binary mode.

    ftp> bin

  • Change directory as indicated:

    ftp> cd storage/tivoli-storage-management-maintenance/client/v3r7

  • Change to the appropriate directory and retrieve the API file.

    • On an AIX 4.3 system:

      ftp> cd AIX/v371 ftp> get tivoli.tsm.client.api.aix43.32bit

    • On a Solaris 2.6 or 7 system:

      ftp> cd Solaris/v371 ftp> get IP21804.tar.Z

  • Use the appropriate tool to install the TSM API package locally:

    • On AIX machines, use smit, which installs the files in the /usr/tivoli/tsm/client/api/bin directory

    • On Solaris machines, use the following command, which installs the files in the /opt/tivoli/tsm/client/api/bin directory:

      # uncompress IP21804.tar.Z | tar xvf -

• Set the following TSM environment variables as indicated. If you do not set them, you must use the default values specified in the TSM documentation.

  • DSMI_DIR

    Specifies the pathname of the directory that contains the TSM client system options file, dsm.sys. The directory must have a subdirectory (which can be a symbolic link) called en_US that contains the dsmclientV3.cat catalog file. Do not put a final slash ( / ) on the directory name. Examples of appropriate values are /opt/tivoli/tsm/client/api/bin on Solaris machines and /usr/tivoli/tsm/client/api/bin on AIX machines.

  • DSMI_CONFIG

    Specifies the pathname of the directory that contains the TSM client user options file, dsm.opt. The value can be the same as for the DSMI_DIR variable. Do not put a final slash ( / ) on the directory name.

  • DSMI_LOG

    Specifies the full pathname (including the filename) of the log file for error messages from the API. An appropriate value is /usr/afs/backup/butc.TSMAPI.log.

• Verify that the dsm.sys file includes the following instructions. For a description of the fields, see the TSM documentation.

  ServerName machine_name CommMethod tcpip TCPPort TSM_port TCPServerAddress full_machine_name PasswordAccess prompt Compression yes

  The following is an example of appropriate values:

  ServerName tsm3 CommMethod tcpip TCPPort 1500 TCPServerAddress tsm3.abc.com PasswordAccess prompt Compression yes

• Verify that the dsm.opt file includes the following instructions. For a description of the fields, see the TSM documentation.

  ServerName machine_name tapeprompt no compressalways yes

• Create a Backup Database entry for each Tape Coordinator that is to communicate with the TSM server. Multiple Tape Coordinators can interact with the same TSM server if the server has sufficient capacity.

  # backup addhost <tape machine name> <TC port offset>

  where

  • tape machine name specifies the fully qualified hostname of the Tape Coordinator machine.

  • TC port offset specifies the Tape Coordinator's port offset number. Acceptable values are integers in the range from 0 (zero) through 58510.

• Create a device configuration file for the Tape Coordinator called /usr/afs/backup/CFG_tcid, where tcid is the Tape Coordinator's port offset number as defined above . The file must include the following instructions:

  • SERVER, which takes as its argument the fully qualified hostname of the TSM server machine. It matches the value in the full_machine_name field of the dsm.sys file, as defined above.

  • TYPE, which takes as its argument the string tsm (the only acceptable value in AFS 3.6).

  • One of PASSWORD or PASSFILE, to define the password which the Tape Coordinator uses when communicating with the TSM server.

    PASSWORD takes as its argument the actual password character string. PASSFILE takes as its argument the complete pathname of the file that contains the string on its first line.