5.2.7 serverindex.xml

After server.xml, the next most important file in a WAS environment is serverindex.xml. This file identifies the mapping of WAS variable names used elsewhere within the WAS configuration and environment to specific ports at the TCP/IP level for each WAS instance running on the node.

This information is important for firewall configuration, and can be useful when configuring the platform or Virtual I/O Server. To run multiple copies of WAS on an environment, or when creating multiple instances of WAS on a node for vertical clustering, these port values must be incremented for each successive instance or environment to avoid port clashes. Errors in this incrementing are one of the most common causes of failure for WAS to start up, along with lack of available memory.

Each instance on the node is identified by a serverEntries element with its role configured by the serverType attribute, and the configuration of the name is within the specialEndPoints element section and the port (or ports) in the endPoint element section; see Example 5-11.

Example 5-11 serverindex.xml

<?xml version="1.0" encoding="UTF-8"?>
<serverindex:ServerIndex xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" 
xmlns:serverindex="http://www.ibm.com/websphere/appserver/schemas/5.0/serverindex.xmi
" xmi:id="ServerIndex_1" hostName="spock44p.RnREnterprise.dyndns.org" 
endPointRefs="NamedEndPoint_1172252985953 NamedEndPoint_1172252985954 
NamedEndPoint_1172252985955 NamedEndPoint_1172252985956 NamedEndPoint_1172252985957 
NamedEndPoint_1172252985958 NamedEndPoint_1172252985959">
  <serverEntries xmi:id="ServerEntry_1172252985953" serverDisplayName="nodeagent" 
serverName="nodeagent" serverType="NODE_AGENT">
    <specialEndpoints xmi:id="NamedEndPoint_1172252985974" 
endPointName="BOOTSTRAP_ADDRESS">
      <endPoint xmi:id="EndPoint_1172252985974" 
host="spock44p.RnREnterprise.dyndns.org" port="2809"/>
    </specialEndpoints>
    <specialEndpoints xmi:id="NamedEndPoint_1172252985953" 
endPointName="ORB_LISTENER_ADDRESS">
      <endPoint xmi:id="EndPoint_1172252985975" 
host="spock44p.RnREnterprise.dyndns.org" port="9900"/>
    </specialEndpoints>
...
</specialEndpoints>
    <specialEndpoints xmi:id="NamedEndPoint_1172252985977" 
endPointName="SOAP_CONNECTOR_ADDRESS">
      <endPoint xmi:id="EndPoint_1172252985984" 
host="spock44p.RnREnterprise.dyndns.org" port="8878"/>
    </specialEndpoints>
  </serverEntries>
  <serverEntries xmi:id="ServerEntry_1172257087924" serverName="spock44pMember01" 
serverType="APPLICATION_SERVER">
    
<deployedApplications>UserTest_war.ear/deployments/UserTest_war</deployedApplications
>
    <specialEndpoints xmi:id="NamedEndPoint_1172257087924" 
endPointName="BOOTSTRAP_ADDRESS">
      <endPoint xmi:id="EndPoint_1172257087924" 
host="spock44p.RnREnterprise.dyndns.org" port="9810"/>
    </specialEndpoints>
...
<specialEndpoints xmi:id="NamedEndPoint_1172257090847" 
endPointName="ORB_LISTENER_ADDRESS">
      <endPoint xmi:id="EndPoint_1172257090847" 
host="spock44p.RnREnterprise.dyndns.org" port="0"/>
    </specialEndpoints>
  </serverEntries>
  <serverEntries xmi:id="ServerEntry_1172338903155" serverName="spock44pMember02" 
serverType="APPLICATION_SERVER">
...
</serverEntries>
</serverindex:ServerIndex>

Default values of port settings in serverindex.xml for Node Agents are listed in Table 5-3.

Table 5-3 Default port values: Node Agent

End point	Port value	Multicast IP Address
BOOTSTRAP_ADDRESS	2809
ORB_LISTENER_ADDRESS	9900
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS	9202
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS	9201
DCS_UNICAST_ADDRESS	9353
DRS_CLIENT_ADDRESS	7888
NODE_DISCOVERY_ADDRESS	7272
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS	5001	ff01::1
NODE_MULTICAST_DISCOVERY_ADDRESS	5000	232.133.104.73
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS	9901
SOAP_CONNECTOR_ADDRESS	8878

Default values of port settings in serverindex.xml for First Instances are shown in Table 5-4.

Table 5-4

End point	Port value
BOOTSTRAP_ADDRESS	9809
SOAP_CONNECTOR_ADDRESS	8879
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS	9401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS	9403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS	9402
WC_adminhost	9060
WC_defaulthost	9080
DCS_UNICAST_ADDRESS	9352
WC_adminhost_secure	9043
WC_defaulthost_secure	9443
SIP_DEFAULTHOST	5060
SIP_DEFAULTHOST_SECURE	5061
SIB_ENDPOINT_ADDRESS	7276
SIB_ENDPOINT_SECURE_ADDRESS	7286
SIB_MQ_ENDPOINT_ADDRESS	5558
SIB_MQ_ENDPOINT_SECURE_ADDRESS	5578
CELL_DISCOVERY_ADDRESS	7277
ORB_LISTENER_ADDRESS	9100

Default port values: First Instance

---