Configuring the storage agent

After the installation is completed, you must configure the storage agent to ensure communication with the backup-archive client and the IBM Storage Protect server. The z/OS media server must be configured to access the Tivoli Storage Manager server.

Procedure

Complete the following steps to configure the storage agent:

Point the server to the storage agent by issuing the DEFINE SERVER command on the IBM Storage Protect server.
Complete the steps in Defining storage agents to the IBM Storage Protect server.
To ensure communication between the storage agent and devices and libraries that are controlled by the z/OS media server, complete the steps in Defining paths from the storage agent to the z/OS media server.
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, edit the dsmsta.opt file by typing the following line:
```
DEVCONFIG devconfig.out
```
The device configuration file can be in the following directory:
- /usr/tivoli/tsm/StorageAgent/bin
- /opt/tivoli/tsm/StorageAgent/bin
- c:\program files\tivoli\tsm\storageagent
Use the information that you collected in the configuration worksheets 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
```
Note:
- The SERVERNAME option in the dsm.sys file, which is the client system options file, must match the SERVERNAME option in the dsm.opt file, which is the client user-options file. However, the option is unrelated to and does not need to match the SERVERNAME option that is defined for the storage agent in the storage-agent options file, dsmsta.opt.
- The HLADDRESS option must match the TCPSERVERADDRESS option that is in the dsm.sys file on the IBM Storage Protect client. When you configure the storage agent by using the DSMSTA SETSTORAGESERVER command, use addresses that correspond to the communications method used by the backup-archive client. With the backup-archive client, you can use either IPv4 (COMMMETHOD TCPIP option) or IPv6 (COMMMETHOD V6TCPIP option), but not both at the same time. To secure communication between the storage agent and the Tivoli Storage Manager server, ensure that your data is protected by Secure Sockets Layer (SSL).
The DSMSTA SETSTORAGESERVER command generates the following output in the storage agent device configuration file:
```
set staname storagnt
set stapassword xxxxxxx
set stakeydbpw 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
```