Configuring the storage agent

Edit online

After the installation is completed, to ensure communication with the backup-archive client and the IBM Storage Protect server, you must configure the storage agent.

Before you begin

Ensure that you complete the steps in Defining storage agents to the IBM Storage Protect server.
Use the information that you collected in the configuration worksheets.

Procedure

Configure the storage agent by completing the following steps:

Point the server to the storage agent by issuing the DEFINE SERVER command on the IBM Storage Protect 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 is in the following directory:
- /usr/tivoli/tsm/StorageAgent/bin
- /opt/tivoli/tsm/StorageAgent/bin
- c:\program files\tivoli\tsm\StorageAgent
Initialize the storage agent and add communication information by issuing 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 that is 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.
- To secure communication between the storage agent and the IBM Storage Protect 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 stahladdress agent.example.com
define server tsmsrver serverpassword=xxxxxxxxxxx
 hladdress=tsmsrver.example.com lladdress=1502
```
In the preceding example, the passwords are encrypted.
The command also generates the following line in the dsmsta.opt file:
```
SERVERNAME tsmsrver
```