Multiple storage agents instances on same machine

Answer

Running more than one Tivoli Storage Manager storage agent on the same machine may be desired under certain circumstances. The following describes the steps required to configure such an environment.

The below example will use the Tivoli Storage Manager 6.2 storage agent for AIX as an example, however, the configuration requirements are similar on all supported versions and platforms.

1) Follow the directions in the Tivoli Storage Manager for SAN for AIX manual. This manual can be found here for Tivoli Storage Manager 6.2:

http://www.ibm.com/support/knowledgecenter/SSGSG7_6.2.0/com.ibm.itsm.sta.doc/t_config_lanfree.html

2) After properly installing one storage agent, there should be one dsmsta.opt and its corresponding devconfig file. The default location for these files is "/opt/tivoli/tsm/StorageAgent/bin/" on UNIX platforms. For example, the storage agent may use a dsmsta.opt file with the following contents :

COMMmethod TCPIP
COMMmethod SHAREDMEM
TCPPORT 1600
TCPADMINPORT 1600
SHMPORT 1610
DEVCONFIG /opt/tivoli/tsm/StorageAgent/bin/devconfig.txt
SERVERNAME MYSERVER_A

The above dsmsta.opt will use the device configuration file at /opt/tivoli/tsm/StorageAgent/bin/devconfig.txt

3) Create a new directory to hold the second storage agent options file. For example,

mkdir /opt/tivoli/tsm/StorageAgent/bin_secondary

Create a new dsmsta.opt using different name, for example dsmsta_secondary.opt.

In this option file, define the TCPPORT, TCPADMINPORT and SHMPORT as well as the devconfig to be unique compared to the original storage agent. For example:

COMMmethod TCPIP
COMMmethod SHAREDMEM
TCPPORT 1700
TCPADMINPORT 1700
SHMPORT 1710
DEVCONFIG /opt/tivoli/tsm/StorageAgent/bin_secondary/devconf_secondary.txt
SERVERNAME MYSERVER_B

This dsmsta will use the device configuration file at /opt/tivoli/tsm/StorageAgent/bin_secondary/devconf_secondary.txt

4) Export the DSMSERV_CONFIG environment variable to the new dsmsta_secondary.opt file. Using the above example, this would be:

export DSMSERV_CONFIG=/opt/tivoli/tsm/StorageAgent/bin_secondary/dsmsta_secondary.opt

5) Run the "dsmsta setstorageserver ... servername=MYSERVER_B..." command to configure the agent devconfig file. This must be done from the new directory as well. For example :

cd /opt/tivoli/tsm/StorageAgent/bin_secondary
export DSMSERV_DIR=/opt/tivoli/tsm/StorageAgent/bin
export DSMSERV_CONFIG=/opt/tivoli/tsm/StorageAgent/bin_secondary/dsmsta_secondary.opt
dsmsta setstorageserver ...

From this point on, to start the second storage agent, the following must be done :

cd /usr/tivoli/tsm/StorageAgent/bin_secondary
export DSMSERV_DIR=/opt/tivoli/tsm/StorageAgent/bin
export DSMSERV_CONFIG=/opt/tivoli/tsm/StorageAgent/bin_secondary/dsmsta_secondary.opt
nohup dsmsta quiet &

Following the above example, the Tivoli Storage Manager client must then use the following options in a stanza of the dsm.sys file to connect to the second storage agent:

lanfreecommmethod tcpip
lanfreetcpport 1700