|If you will be using a Tivoli Storage Agent with ACSLS-managed libraries, |you must have the ACSLS software and the third-party external library software |(such as, Gresham EDT-DistribuTAPE) installed and configured. See Figure 4 for an example of a Storage Agent in an ACSLS-managed |library environment. See the StorageTek ACSLS and the Gresham EDT |documentation for installation instructions.
|The server system and the client systems must be attached to the SAN along |with appropriate storage devices. The server system and the client |systems must also be connected by means of a LAN.
|The Managed System for SAN feature requires specific levels and models of |hardware and software. Ensure that your system configuration meets the |hardware and software requirements for the SAN setup. See the Web site, |http://www.tivoli.com/support/storage_mgr/san/overview.html, |for details.
|Figure 7 shows the results of completing Step 2. Client System and Step 3. Server.
|Figure 7. Communications information. Results of Steps 2 and 3. The passwords are shown as "xxxxxxx" because they are encrypted in the file.
![]() |
|Do the following on the client system: |
|For information about the dsm.opt and dsm.sys files, see |Tivoli Storage Manager Installing the Clients. |
|commmethod tcpip |tcpserveraddress garden.tucson.tivoli.com |tcpport 1501
|and
|commmethod sharedmem |shmport 1511
|servername garden
|enablelanfree yes | |LANFREECommethod TCPIP |LANFREETCPPORT 1501and
|LANFREECommethod SharedMem |LANFREESHMPORT 1511|
|SErvername server_a |COMMmethod TCPip |TCPPort 1500 |TCPServeraddress server_a.domain.company.COM
|It is assumed that the dsm.sys file is controlled by the system |administrator. The Tivoli Storage Manager server administrator should |supply the name and IP address of the Tivoli Storage Manager server, as well |as the node name and password. |
|The following are examples on how to set up these environment |variables.
|export DSMI_CONFIG=APIINSTALLPATH/dsm.opt |export DSMI_DIR=APIINSTALLPATH |export DSMI_LOG=/home/user_a/logdir
|The Tivoli Storage Manager API client user must be logged in as root or |have the same user ID as the process running the Tivoli Storage Manager |server. |
|
| |On the same system as the client, install the storage agent. The |default installation directory is |/usr/tivoli/tsm/StorageAgent/bin.
|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).
|Here is the SMIT procedure: |
|Enter:
|+--------------------------------------------------------------------------------+ ||smit install_update & | |+--------------------------------------------------------------------------------+
|For AIX 4.3, select:
|+--------------------------------------------------------------------------------+ ||Install and Update Software | || Install and Update from the LATEST Available Software | |+--------------------------------------------------------------------------------+
|For AIX 5.1, select:
|+--------------------------------------------------------------------------------+ ||Install Software | || Install Software | |+--------------------------------------------------------------------------------+
|If you click on List, select the CD-ROM drive that you are using |for the installation (for example, /dev/cd0).
|
|Table 4. Package and Fileset Names for Installation
AIX 4.3.3 Platforms | ||
Package Name | Fileset Names | Description |
---|---|---|
tivoli.tsm.StorageAgent.rte | tivoli.tsm.StorageAgent.rte | StorageAgent common functions, examples |
tivoli.tsm.devices.aix43.rte | tivoli.tsm.devices.aix43.rte | SCSI runtime device support |
tivoli.tsm.msg.en_US.devices | tivoli.tsm.msg.en_US.devices | SMIT screens |
tivoli.tsm.msg.en_US.server | tivoli.tsm.msg.en_US.server | Message catalog and Online help |
|
|Table 5. Package and Fileset Names for Installation
AIX 5.1 Platforms | ||
Package Name | Fileset Names | Description |
---|---|---|
tivoli.tsm.StorageAgent.rte | tivoli.tsm.StorageAgent.rte | StorageAgent common functions, examples |
tivoli.tsm.devices.aix5.rte64 | tivoli.tsm.devices.aix5.rte64 | SCSI runtime device support |
tivoli.tsm.msg.en_US.devices | tivoli.tsm.msg.en_US.devices | SMIT screens |
tivoli.tsm.msg.en_US.server | tivoli.tsm.msg.en_US.server | Message catalog and Online help |
|SMIT responds:
|+--------------------------------------------------------------------------------+ ||ARE YOU SURE?... | |+--------------------------------------------------------------------------------+
|This installation may take several minutes.
|dsmsta setstorageserver myname=iris mypassword=jonquil |myhladdress=arbor.tucson.tivoli.com |servername=garden serverpassword=botanical |hladdress=garden.tucson.tivoli.com lladdress=1500 |
|See Set Installation Data for the Storage Agent: DSMSTA SETSTORAGESERVER for the details on the command parameters.
|The command generates the following lines in the device configuration file |for the storage agent:
|+--------------------------------------------------------------------------------+ ||SET STANAME iris | ||SET STAPASSWORD xxxxxxx | ||SET STAHLADDRESS arbor.tucson.tivoli.com | ||DEFINE SERVER garden serverpassword=botanical | || HLADDRESS=garden.tucson.tivoli.com LLADDRESS=1500 | || | |+--------------------------------------------------------------------------------+
|The passwords (shown here as xxxxxxxx) are encrypted in the |file.
|The command also generates the following line in the dsmsta.opt |file:
|+--------------------------------------------------------------------------------+ ||SERVERNAME garden | |+--------------------------------------------------------------------------------+| | |See The Storage Agent Options File and The Device Configuration File for the Storage Agent for details on these files.
|Using the editor of your choice open the device configuration file and add |the library named stk-lib, set the libtype to external with lanfree and |obeymountretention equalling yes. Gresham EDT-DistribuTape is the |external library manager interfacing with the ACSLS library software, the EDT |executable is located in its default path /usr/lpp/dtelm/bin/elm. With |the device configuration file open you would add the following entry to the |bottom of the file:
|+--------------------------------------------------------------------------------+ ||DEFINE LIBRARY stk-lib libtype=external lanfree=yes obeymountretention=yes | || EXTERNALMANAGER=/usr/lpp/dtelm/bin/elm | || | |+--------------------------------------------------------------------------------+
|The resulting device configuration file would appear as:
|+--------------------------------------------------------------------------------+ ||SET STANAME iris | ||SET STAPASSWORD xxxxxxx | ||SET STAHLADDRESS arbor.tucson.tivoli.com | ||DEFINE SERVER garden serverpassword=xxxxxxxxxxx | || HLADDRESS=garden.tucson.tivoli.com LLADDRESS=1500 | ||DEFINE LIBRARY eagle-lib libtype=external lanfree=yes obeymountretention=yes | || EXTERNALMANAGER=/usr/lpp/dtelm/bin/elm | || | |+--------------------------------------------------------------------------------+
|Save and close the file. |
|The following is an overview of the steps that you need to do on the TSM |server. For details, see Administrator's Guide. |On the server, do the following: |
|Tape Device |
|define library stk-lib libtype=external lanfree=yes obeymountretention=yes | externalmanager=/usr/lpp/dtelm/bin/elmIn the previous example the path provided for the external manager is |dependent upon the operating system where the TSM server resides. For |example, an AIX TSM server external manager path is /usr/lpp/dtelm/bin/elm in |contrast to a TSM Sun server external manager path of /opt/OMIdtelm/bin/elm or |a TSM Windows server external manager path of c:\program |files\GES\EDT\bin\elm.exe. For additional information about the |DEFINE LIBRARY command, see the Tivoli Storage Manager Administrator's |Reference.
|define server iris serverpassword=jonquil |hladdress=sanclient.tucson.tivoli.com lladdress=1500
|See Administrator's Reference for details on the |commands.
|To review the expected results of the steps that you have just completed, |see Figure 5. |
|In step 4 you will enable and start the device driver in order to support |the tape device. In contrast to other configurations documented in this |publication External library support does not require TSM drive |mapping. Instead the Gresham middleware product provides the drive |mapping.
|Do the following: |
|Start the storage agent by changing to the storage agent directory and |issue the following command:
|dsmsta
|To verify that you have configured your system correctly for LAN-free data |movement, perform the following procedure: |
|Use the following guidelines to help determine whether the data movement is |using the LAN-free environment: |
|query actlog search=storage_agent_name msgno=8337
|or
|query actlog search=storage_agent_name
|netstat -D
|