[Java programming language only]

Configuring the Object Request Broker in a WebSphere Application Server environment

[Version 8.6 and later](Deprecated) You can use WebSphere® eXtreme Scale with applications that use the Object Request Broker (ORB) directly in WebSphere Application Server or WebSphere Application Server Network Deployment environments.

[Version 8.6 and later]

About this task

[Version 8.6 and later]Deprecated featureDeprecated: The Object Request Broker (ORB) is deprecated. If you were not using the ORB in a previous release, use IBM® eXtremeIO (XIO) for your transport mechanism. If you are using the ORB, consider migrating your configuration to use XIO.

Procedure

  1. Name your application servers appropriately.

    You cannot have servers in a WebSphere Application Server environment with the same name when the servers are using the ORB to communicate with each other. You can resolve this restriction by specifying the system property -Dcom.ibm.websphere.orb.uniqueServerName=true for the processes that have the same name. For example, when servers with the name server1 on each node are used as a catalog service domain, or where multiple node agents are used to form a catalog service domain.

  2. Tune the ORB properties within the WebSphere Application Server configuration.

    See ORB properties for more information about the properties that you can tune. Depending on the property, you might change a setting in the administrative console or in the was_rootproperties/orb.properties file.

  3. If you are using multiple network interface cards, you must set the ORB_LISTENER_ADDRESS value in the ports panel in the WebSphere Application Server administrative console. Repeat this step for each application server in the configuration.
    1. For an application server, click Servers > Application servers > server_name. Under Communications, click Ports. The Ports panel is displayed for the specified server.
    2. Click Details and edit the ORB_LISTENER_ADDRESS value.
    3. Enter the IP address in the Host field. This value must be a private address for a multiple network interface environment.
      Note: DNS host names are not supported for the ORB_LISTENER_ADDRESS value.
    4. Enter the port number in the Port field.
      The port number specifies the port for which the service is configured to accept client requests. The port value is used with the host name.

What to do next

You can use the wxsLogAnalyzer tool to verify the ORB settings across your environment. See Analyzing log and trace data for more information.