Sharedmem Commmethod setup in a Storage Agent environment

Resolving The Problem

The storage agent supports communications over shared memory. Here is an example of how to setup/change to COMMMETHOD SHAREDMEM in a LANFREE environment from the default of TCPIP.

Note that the storage agent COMMMETHOD TCPIP is still required for server to storage agent communications.

Client/Storage Agent IP Address:
192.168.100.100

Server IP Address:
192.168.100.200

1. Edit the client dsm.opt/dsm.sys file to verify the TCP/IP and shared memory address and ports the client will use to communicate with the server and storage agent respectively:

* The following is how the client connects to the server via TCPIP:
COMMMETHOD TCPIP
TCPSERVERADDRESS 192.168.100.200
TCPPORT 1500

* The following is how the client connects to the storage agent via SHAREDMEM:
ENABLELANFREE YES
LANFREECOMMMETHOD SHAREDMEM
LANFREESHMPORT 1510

Here is a complete example:

[user@server bin]$ cat /opt/tivoli/tsm/client/ba/bin/dsm.sys
SERVERNAME                TSM01
   COMMMethod              TCPip      
   TCPServerAddress        192.168.100.200
   TCPPort                 1500        
   TCPClientAddress        192.168.100.100
   TCPClientPort           1501
   PASSWORDACCESS          GENERATE
   NODENAME                NODE
   SCHEDMODE               prompted
   MANAGEDSERVICES         schedule webclient
   ENABLELANFREE           YES
   *LANFREECOMMMETHOD       TCPIP      
   *LANFREETCPPort          1600      
   LANFREECOMMMETHOD       SHAREDMEM  
   LANFREESHMPORT          1510    

2. In the storage agent dsmsta.opt file, verify that the storage agent is configured to be listening on both TCPIP and SHAREDMEM ports when accepting communications from the client and server respectively:

COMMMETHOD TCPIP
TCPPORT 1600
COMMMETHOD SHAREDMEM
SHMPORT 1510

Here is a complete example:

[user@server bin]$ cat /opt/tivoli/tsm/StorageAgent/bin/dsmsta.opt
SERVERNAME        TSM01
  COMMMETHOD      TCPIP              
  COMMMETHOD      SHAREDMEM      
  TCPPORT         1600
  ShmPort         1510        
  DEVCONFIG       devconfig.txt

3. In the server dsmserv.opt file, verify that the TCP/IP address and port the server is configured to listen on for incoming requests from the client and storage agent:

COMMMETHOD TCPIP
TCPPORT 1500

Note: The above values are the default, so they may not be explicitly referenced in the dsmserv.opt.

4. On the server, use the QUERY/DEFINE/UPDATE SERVER command to verify, define or update the TCP/IP address and port the server will communicate to the storage agent on:

DEFINE SERVER stgagentname HLA=192.168.100.100 LLA=1600
OR:
UPDATE SERVER stgagentname HLA=192.168.100.100 LLA=1600

Note: The programs (server, client, and storage agent) will need to be stopped and restarted if any changes are made to dsm.sys/opt, dsmsta.opt, or dsmserv.opt.