Network Deployment (Distributed operating systems), v8.0 > Set up the application serving environment > Balancing workloads > Create clusters

Enable static routing for a cluster

If your high availability infrastructure is disabled and you require IIOP routing capabilities, you can create a static routing table for the members of a cluster to use to handle enterprise bean requests. Because the information contained in this static routing table does not account for server runtime state, you should delete this table and return to using the dynamic routing table as soon as your high availability infrastructure is enabled.

Before you create a static route table, ensure that:

• The ORB_LISTENER_ADDRESS port is set to a non-zero value on each of the cluster members. Because the route table you create is static, and the cluster members do not communicate during state changes, if you do not set the ORB_LISTENER_ADDRESS port on each of the cluster members, the cluster members might restart on different ports, and IIOP requests will not be routed correctly.

  To change the value specified for the ORB_LISTENER_ADDRESS port:

  1. In the admin console, click...

         Servers > Server Types > WebSphere application servers > server_name

     and then under Communications, click Ports .

  2. Click ORB_LISTENER_ADDRESS in the Port name field.

  3. Change the value specified for the Port field to a value that is greater than 0.

• Each cluster member is started and can use these new non-zero ORB_LISTENER_ADDRESS port values to correctly route IIOP requests.

You should only create a static route table if your high availability infrastructure is disabled and you require IIOP routing capabilities.

To create a static route table:

Procedure

1. Start wsadmin.sh if it is not already running.

2. Identify the cluster managed bean (MBean) for the cluster for which you are creating the route table, and assign that MBean to a variable.

   ### Jacl

   cluster = AdminControl.completeObjectName('cell=
     cell_name,type=Cluster,name=cluster_name,*')
   print cluster
   

   ### Jython

   set cluster [$AdminControl completeObjectName cell=
      cell_name,type=Cluster,name=cluster_name,*]
   puts $cluster
   

   These commands return the name of the cluster MBean for the specified cluster. For example, for cluster cluster1, the output from these commands will be similar to the following message:

   WebSphere:cell=mycell,name=cluster1,mbeanIdentifier=Cluster,type=
      Cluster,process=cluster1
   

3. Export the route table.

   ### Jacl

   $AdminControl invoke $cluster exportRouteTable
   

   ### Jython

   AdminControl.invoke(cluster, ‘exportRouteTable’)
   
   

   After the table is created, the name of the route table file, is displayed in a message similar to the following message:

   /home/myInstall/was/server/profiles/dmgrProfile/config/cells/mycell/
      clusters/cluster1/cluster1.wsrttbl
   

   As this message illustrates, the file containing the table is placed in the config directory of the dmgr for that cluster. You should keep a record of this location so that you can delete this file when you are ready to start using dynamic routing again.

4. Synchronize the configuration changes across nodes.

   1. Clear the configuration repository Epoch. If you do not clear the configuration repository Epoch, the synchronization only updates the files that the configure service component edited, which does not include the file that contains the static routing table.

      ### Jacl

      set configRepository [$AdminControl completeObjectName
           node=node_name,type=ConfigRepository,*]
      $AdminControl invoke $configRepository refreshRepositoryEpoch
      

      Using Jython:

      configRepository = AdminControl.completeObjectName('node=node_name,     type=ConfigRepository,*')
      AdminControl.invoke(configRepository, 'refreshRepositoryEpoch')
      

   2. Repeat this process for each node to synchronize.

5. Stop the cluster. Follow the instructions specified either the Stop clusters or Stopping clusters using scripting topic.

6. Exit wsadmin.sh.

7. Use the following Debug flag appended to the startServer command to manually start each member of this cluster.

   -Dcom.ibm.websphere.management.registerServerIORWithLSD=false
   

   For example, to start server1 on a Windows operating system with static routing enabled, issue the following command from the server profile’s bin directory:

   startServer.bat server1 -Dcom.ibm.websphere.management.registerServerIORWithLSD=false
   
   

Results

The cluster members use the static route table to perform IIOP routes.

What to do next

When your high availability infrastructure is enabled, follow the instructions in the topic Disable static routing for a cluster to disable static routing. When static routing is disabled, the cluster members resume using dynamic routing.
Disable static routing for a cluster
Saving configuration changes with wsadmin.sh
Synchronize nodes using wsadmin.sh
Start the wsadmin scripting client using wsadmin.sh
Stop clusters
Stop clusters using scripting
Create clusters

Related

Java virtual machine custom properties
Start clusters
Start clusters using scripting

+

Search Tips   |   Advanced Search