The InterChange Server system uses the IBM Java Object Request Broker (ORB) to handle ORB communication between InterChange Server and individual connectors. This section describes how configure the ORB.
The InterChange Server Installer installs the IBM Java ORB automatically as part of the Java Runtime Environment (JRE). During the installation process, Installer assigns a port of 14500 to the ORB. It also displays the Services screen to determine whether you would like to install InterChange Server as a Windows service. In this case, you specify the port number for the ORB to use (5500 by default). Other than this step, no tasks are required to install the IBM Java ORB.
This section provides the following configuration information for the IBM Java ORB:
By default, IBM Java ORB configuration is handled as part of its installation process. However, the IBM Java ORB supports several properties you can set to customize the ORB. These properties include the location of the ORB, number of ORB threads, and timing values. For a complete explanation of these properties and how to set them, refer to the System Administration Guide.
In an HA environment, the IBM Java ORB must be configured to support use of the Persistent Naming Service and a virtual IP address. To do this, follow these steps:
The Persistent Naming Server is required for the HA environment. By default, it is enabled. To start the Persistent Naming Server, use the PersistentNameServer.bat file. For information, see Before starting InterChange Server.
The IBM Transient Naming Server provides the naming service for the InterChange Server system. It keeps track of the CORBA objects that are active. For the HA environment, this Transient Naming Server must be installed as a Windows service. The InterChange Server product provides the CWService utility to register ICS components as Windows services. This tool resides in the bin subdirectory of the product directory. You can use the following syntax of the CWService utility to register the Transient Naming Server as a Windows service:
cwservice -xi -tNAMESERVER -c ProductDir\bin\PersistentNameServer.bat -mode=Auto -s serviceName
where serviceName is the name to assign to the Transient Naming Server's service. This command launches the cwservice tool, indicates that the component associated with this service is the Transient Naming Server, specifies the startup script to be used, sets the service to automatic start, and defines the service name.
For more information on the CWService tool, see Running components as Windows services
In addition to installing the Transient Naming Server as a Windows service, the HA environment requires that InterChange Server and adapters be installed as services. You can use the CWServices tool to perform these configurations (if they are not already configured as services on your system).
In an HA environment, InterChange Server system must be able to run on a multi-homed machine (a machine with multiple NIC cards). IBM Java ORB must be configured to use the virtual IP address, not the IP address on the private network between the two hosts. You must configure the virtual IP address in the following IBM Java ORB property com.ibm.CORBA.LocalHost.
To configure this ORB property, follow these steps:
com.ibm.CORBA.LocalHost
This is an example of a virtual IP address:
10.5.1.214 255.255.255.0 10.5.1.255
In this example, 10.5.1.214 is the IP address, 255.255.255.0 is the subnet mask, and 10.5.1.255 is the local broadcast address.
-Dcom.ibm.CORBA.LocalHost=com.ibm.CORBA.LocalHost