Installing and configuring the storage agent (AIX)

The storage agent must be installed on a client system that has connections to storage resources on the SAN.

Before beginning this procedure:

• Verify that your system meets the hardware and software requirements.
• Be sure that you have the information recorded in the configuration-information work sheets.
• Close all existing Tivoli® Storage Manager products prior to installing the storage agent. Installation will stop if an active Tivoli Storage Manager process is detected. If this occurs, close all active Tivoli Storage Manager products and retry installing the storage agent.

The storage agent honors the Tivoli Storage Manager server environment variables DSMSERV_CONFIG.
The instructions in this section are shown using the Software Management and Installation Tool (SMIT). You can also use the Install and Update Software Manager (installm). To reduce workload and processing time and to optimize LAN-free performance, do not install the storage agent and the Tivoli Storage Manager server on the same system.
To install and configure the storage agent:

1. Log in as the root user.
2. Insert the storage agent CD into the selected drive. For example: /dev/cd0.
3. From your desktop, access SMIT and make selections according to the level of your AIX® operating system:
   1. Enter smit install_update &
   2. Select:

      Install Software
        Install Software

4. On the next window, select the device that you are using for the installation. You can enter the drive name in the window or click List to access the device list. If you click List, select the CD drive that you are using for the installation.
5. Click OK.
6. Locate the line Software to Install. Before proceeding, review the software listed in the table.

   Table 1. Package and fileset names for AIX 5.3 ML6 SP2

   Package and fileset names	Description
   tivoli.tsm.StorageAgent	Storage agent common functions, sample dsmsta.opt file
   tivoli.tsm.gsksa.rte	Encryption and Secure Socket Layer (SSL) capabilities in the storage agent
   tivoli.tsm.devices	SCSI-runtime device support
   tivoli.tsm.devices.msg.xx_XX	SMIT windows
   tivoli.tsm.server.msg.xx_XX.server	Message catalog and online help

   The variable xx_XX represents the country code for the language contents of the package.
   • To install all components in the table, continue at step 8.
   • To selectively install components, click List for the latest available software packages and select the components that you need. Required components are the storage agent and the message package to be used by the storage agent. The Tivoli Storage Manager device driver is only required if you are using a SCSI device that is not covered by an IBM® SCSI device driver. For a list of devices supported by the Tivoli Storage Manager SCSI device driver, refer to the Tivoli Storage Manager product support Web site.
7. Click OK.
8. Check the default settings for the options on this window.
9. Click OK. SMIT responds:

   ARE YOU SURE?...

10. Click OK. This installation can take several minutes.
11. After the installation is complete, click Done , remove the CD, and exit SMIT.
12. Ensure that the DEVCONFIG option is specified in the storage agent options file (dsmsta.opt). For example, for a device configuration file named devconfig.out located at /usr/tivoli/tsm/StorageAgent/bin, edit the dsmsta.opt file and enter the following line: DEVCONFIG devconfig.out
13. Use the information that you collected in the configuration-information work sheets to issue the DSMSTA SETSTORAGESERVER command. For example:

    dsmsta setstorageserver myname=storagnt mypassword=fun4me
    myhladdress=agent.example.com
    servername=tsmsrver serverpassword=not4u
    hladdress=tsmsrver.example.com lladdress=1502

    The HLADDRESS must match the TCPSERVERADDRESS located in the dsm.sys file on the Tivoli Storage Manager client. When configuring the storage agent using the DSMSTA SETSTORAGESERVER command, use addresses that correspond to the communications method used by the backup-archive client. The backup-archive client supports either IPv4 (COMMMETHOD TCPIP) or IPv6 (COMMMETHOD V6TCPIP), but not both at the same time. The command generates the following lines in the device configuration file for the storage agent:

    set staname storagnt
    set stapassword xxxxxxx
    set stahladdress agent.example.com
    define server tsmsrver serverpassword=xxxxxxxxxxx
     hladdress=tsmsrver.example.com lladdress=1502

    The passwords (shown as xxxxxxxxxxx) are encrypted in the file.
    The command also generates the following line in the dsmsta.opt file: SERVERNAME tsmsrver
    

The default installation directory is /opt/tivoli/tsm/StorageAgent/bin.