DSMSTA SETSTORAGESERVER command

Use the DSMSTA SETSTORAGESERVER command to initialize the storage agent and add communication information to the device configuration file and the storage agent options file dsmsta.opt.

Use this utility on the client system where the storage agent is installed.

This utility does not remove any previous entries in the files. It appends information to the existing files. The option DEVCONFIG, which sets a name for the device configuration file, must be in the dsmsta.opt file for the command to work. See Examples.

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. The backup-archive client supports either IPv4 (COMMMETHOD TCPIP) or IPv6 (COMMMETHOD V6TCPIP), but not both at the same time.

Syntax


>>-DSMSTA SETSTORAGESERVER--MYName--=--storage_agent_name------->

>--MYPAssword--=--storage_agent_password------------------------>

>--MYHLAddress--=--storage_agent_hladdress---------------------->

>--SERVERName--=--server_name----------------------------------->

>--SERVERPAssword--=--server_password--------------------------->

>--HLAddress--=--server_tcpip_address--------------------------->

>--LLAddress--=--server_tcpip_port------------------------------>

>--STAKEYDBPW--=--obfuscated_password--SSL--=--YES-------------><

Parameters

All parameters are required. Allowed abbreviations for the options are shown in uppercase letters.

MYName: Specifies the name of the storage agent. This name is displayed in the SET STANAME command that is inserted into the device configuration file.
You must use the same name when you define the storage agent as a server to the Tivoli® Storage Manager server.
MYPAssword: Specifies the password of the storage agent. This value is encrypted and used in the SET STAPASSWORD command that is inserted into the device configuration file.
You must use the same password when you define the storage agent as a server to the Tivoli Storage Manager server.
MYHLAddress: Specifies the TCP/IP address of the storage agent. This value is used internally in the SET STAHLADDRESS command that is inserted into the device configuration file.
SERVERName: Specifies the name of the Tivoli Storage Manager server. This name is displayed in the DEFINE SERVER command that is inserted into the device configuration file.
SERVERPAssword: Specifies the password of the server. This value is encrypted and is displayed in the SERVERPASSWORD parameter of the DEFINE SERVER command that is inserted into the device configuration file.
HLAddress: Specifies the TCP/IP address of the server. This value is used in the HLADDRESS parameter of the DEFINE SERVER command.
LLAddress: Specifies the TCP/IP port on which to access the server. This value is used in the LLADDRESS parameter of the DEFINE SERVER command.
SSL: Specifies whether the storage agent will use Secure Sockets Layer (SSL) for communicating with the server. The default value is NO.
STAKEYDBPW: Specifies the password that is used to verify and control access to the SSL key database. The value of the STAKEYDBPW parameter is stored in the storage agent options file.

Examples

Issue the DSMSTA SETSTORAGESERVER command with the following information:

Storage agent
- Name: storagnt
- Password: fun4me
- TCP/IP address: agent.example.com
Tivoli Storage Manager server
- Name: tsmsrver
- Password: not4u
- TCP/IP address: tsmsrver.example.com
- SSL port: 1542

The command is:

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

The command generates the following lines in the device configuration file for the storage agent:

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

The passwords (shown as xxxxxxxx) are encrypted in the file.

The command also generates the following line in the dsmsta.opt file for the storage agent:

servername tsmsrver

To enable SSL communication and to ensure that the storage agent is authenticated through an LDAP directory server, issue the following command:

dsmsta setstorageserver myname=storagnt mypassword=fun4me
myhladdress=agent.example.com
servername=tsmsrver serverpassword=not4u
ssl=yes
stakeydbpw=password
hladdress=tsmsrver.example.com lladdress=1500
ssltcpport=1543