Clustering › Meet the Prerequisites

Meet the Prerequisites

To implement clustering successfully, meet its prerequisites.

Follow these steps:

1. Verify that no other application uses the following ports.

   By default, CA Service Catalog uses these ports for clustering, using the AJP protocol:

   • 8009 – for CA Service Catalog communicating with Apache HTTP Server
   • 8019 – for Service Fulfillment communicating with Apache HTTP server
2. Perform this step if applicable; otherwise, skip it.
   1. If another application uses one of these port numbers, eliminate the duplication by using a different port number for either CA Service Catalog or the other application.
   2. If you use a different port number for CA Service Catalog, then also replace the old port number with the new port number in the applicable clustering topics in this documentation. For example, if you change 8009 to a different port number, use the new port number instead of 8009 when you set up horizontal clustering for CA Service Catalog.
3. Verify the multicast address for Tomcat, as follows:
   1. In the USM_HOME\view\conf folder, open the server.xml file for editing.
   2. Locate and record the multicast address for Tomcat.

      This address is the value of the mcastAddr attribute within the Membership tag. The default is 228.0.0.4, as shown in the following sample specification:

      <Membership className="org.apache.catalina.tribes.membership.McastService"
                     address="228.0.0.4"
                     port="45564"
                     frequency="500"
                     dropTime="3000"/>
      

4. Verify the multicast address for Java Messaging Service (JMS), as follows:
   1. In the USM_HOME folder, open the config.properties file for editing.
   2. Locate and record the multicast address for JMS.

      The default is 239.255.2.3:6155, as shown in the section that begins with the heading #JMS related configuration.

5. Run the following command at the DOS prompt of each clustered computer:

   netsh interface ip show joins 
   

   The command lists all multicast addresses applicable to this computer.

6. Verify that this list includes the multicast addresses that you recorded from the server.xml and config.properties files:
   • If Yes, then skip the remaining steps in this topic.
   • If No, then use the list to determine a common multicast address applicable to all clustered computers, and complete the remaining steps.
7. Follow these steps:
   1. Update the multicast addresses in the server.xml files on all clustered computers to use this common address.
   2. In the config.properties files on all clustered computers, edit the JMS-related configuration section mentioned earlier. Edit that section to specify this common address, as shown in the following example.

      Important! The port number must be the same on each computer in the cluster.

      #multicast://default = multicast://239.255.2.3:6155
      #static:(tcp://<host1>:<port>,tcp://<host2>:<port>,...)
      jms.networkConnectorUri = multicast://custom-ip-address:custom-port
      jms.discoveryUri = static: multicast://custom-ip-address:custom-port
      #jms.port = 7777
      jms.port = custom-port
      

   3. (Alternative) If you want to specify your nodes statically instead of using a multicast address, perform this step instead of step b.

      In the config.properties files on all clustered computers, edit the JMS-related configuration section mentioned earlier. Edit that section to specify the host and port for all other computers in the cluster, as shown in the following example.

      The port number can be the same value on each computer in the cluster, or it can be different.

      #multicast://default = multicast://239.255.2.3:6155
      #static:(tcp://<host1>:<port>,tcp://<host2>:<port>,...)
      jms.networkConnectorUri = static:(tcp://host:custom-port)
      jms.discoveryUri = static:(tcp://host:custom-port)
      #jms.port = 7777
      jms.port = custom-port
      

   Note: Update the server.xml and config.properties files on all clustered computers before proceeding to the next step.

8. Restart the CA Service Catalog Windows service on all clustered computers.

You have met the prerequisites.