Node Definition example for a Shared Catalog Implementation

The following example shows sample configuration statements for a Shared Catalog implementation. The example is also designed to facilitate the movement of the Catalog Node from the default system to either of the systems on which a Request Node is defined. With this configuration, you can stop the Tape Manager service machines for the Catalog Node on the default system and bring up the Tape Manager service machines for the Catalog Node on a different system.

In an SSI environment, all of the service machines for the Catalog Node would be defined as single configuration IDs (i.e. USER IDs) and the all of the service machines for the Request Nodes could be defined as multiple configuration IDs (i.e. IDENTITY IDs). To avoid conflicts when the Catalog Node is moved, the service machine names for the Catalog Node must be different from the service machine names for the Request Nodes. In this example, assume that the Catalog Node service machine names begin with TC (for example, TCTMM) and the Request Node service machine names begin with TR (for example, TRTMM).

Note: In a Shared Catalog implementation, the service machine names on the catalog node can be the same as those on the request node. However, if there is a possibility that the catalog node could be moved to the system where the request node is running, the service machine names on the catalog node must be different than those on the request node.
Note: The catalog node must have access to the same disks on any system where it will run, whether or not it is running in an SSI environment.

Definitions for the Catalog Node

To facilitate the movement of the Catalog Node from the default system (SYS10) to either of the systems running the request nodes, some accommodations have been made. By omitting the TCPIP_Machine parameter from the local node definition, the catalog node will use the default TCPIP machine name on the system where it is started.

Likewise, by specifying the Host_Addr parameter as 0.0.0.0, the catalog node will use the default IP address on the system where it is started. Note that the Host_Name parameter has been omitted since it would override the Host_Addr parameter if it was resolved, thereby preventing communications on the systems where the Request Nodes are defined.

For the remote Request Nodes, the Host_Addr values are specified and will be used if for some reason the host name does not resolve on the catalog system. The omission of the TCPIP_machine parameter and the use of 0.0.0.0 to designate a default IP address both require PTF UI29840.

Figure 1. System: SYS10 IP Address: 192.168.20.10
Define_Local_Node,             
   Node_Name TMCAT,             
   Node_Type CATALOG,           
   Initial_Status START,        
   Challenge_Password abc123,  
   Host_Addr 0.0.0.0,           
   Host_Port 31000,             
   Retry_Minutes 1,             
   Retry_Limit 10               
                                
 Define_Remote_Node,            
   Node_Name TMREQ20,           
   Node_Type REQUEST,          
   Initial_Status START,       
   Challenge_Password 123abc,  
   Host_Name SYS20,             
   Host_Addr 192.160.20.20,     
   Host_Port 32000,             
   Device_Manager TRDMM,        
   Retry_Minutes 1,             
   Retry_Limit 10               
                                
 Define_Remote_Node,            
   Node_Name TMREQ30,           
   Node_Type REQUEST,           
   Initial_Status START,        
   Challenge_Password 123abc,   
   Host_Name SYS30,             
   Host_Addr 192.168.20.30,     
   Host_Port 33000,             
   Device_Manager TRDMM,        
   Retry_Minutes 1,             
   Retry_Limit 10               

Definitions for Request Nodes

This section includes examples of how to define request nodes. The use of the Host_Altaddrs parameter below allows connections from the Catalog Node to originate from either system SYS20 or SYS30, in addition to the default system SYS10.

In the example below for TMREQ20, the alternate connections will be allowed from any of the following:

  • the SYS20 or SYS30 resolved name addresses,
  • the default IP address for SYS20 where TMREQ20 runs,
  • the hard-coded address for system SYS30 where TMREQ30 runs.

The use of the Host_Altaddrs parameter and the use of 0.0.0.0 to designate a default IP address require PTF UI29840.

Figure 2. System: SYS20 IP Address: 192.168.20.20
 Define_Local_Node,             
   Node_Name TMREQ20,             
   Node_Type REQUEST,           
   Initial_Status START,        
   Challenge_Password 123abc,  
   Tcpip_Machine TCPIP, 
   Host_Name SYS20,            
   Host_Addr 0.0.0.0,           
   Host_Port 32000,             
   Retry_Minutes 1,             
   Retry_Limit 10               
                                
 Define_Remote_Node,           
   Node_Name TMCAT,            
   Node_Type CATALOG,          
   Initial_Status START,       
   Challenge_Password abc123,  
   Host_Name SYS10,            
   Host_Addr 192.168.20.10,    
   Host_Altaddrs,              
     SYS20 SYS30,              
     0.0.0.0 192.168.20.30,    
   Host_Port 31000,            
   Retry_Minutes 1,            
   Retry_Limit 10              
In the example below for TMREQ30, the alternate connections will be allowed from any of the following:
  • the SYS20 or SYS30 resolved name addresses,
  • the default IP address for SYS30 where TMREQ30 runs,
  • the hard-coded address for system SYS20 where TMREQ20 runs.

The omission of the Host_Altaddrs parameter and the use of 0.0.0.0 to designate a default IP address both require PTF UI29840.

Figure 3. System: SYS30 IP Address: 192.168.20.30
 Define_Local_Node,             
   Node_Name TMREQ30,             
   Node_Type REQUEST,           
   Initial_Status START,        
   Challenge_Password 123ABC,  
   Tcpip_Machine TCPIP, 
   Host_Name SYS30,            
   Host_Addr 0.0.0.0,           
   Host_Port 33000,             
   Retry_Minutes 1,             
   Retry_Limit 10               
                                
 Define_Remote_Node,           
   Node_Name TMCAT,            
   Node_Type CATALOG,          
   Initial_Status START,       
   Challenge_Password abc123,  
   Host_Name SYS10,            
   Host_Addr 192.168.20.10,    
   Host_Altaddrs,              
     SYS20 SYS30,              
     192.168.20.30 0.0.0.0,    
   Host_Port 31000,            
   Retry_Minutes 1,            
   Retry_Limit 10