Clustering › How to Set Up Vertical Clustering for Service View › Set Up Each Additional Cluster

Set Up Each Additional Cluster

This procedure is required to set up vertical clustering for Service View. Set up each additional cluster that you want to create. You perform this procedure one to many times, once for each new cluster that you want to create in addition to the original installation. For example, to set up two new clusters in addition to the original installation, you perform this procedure twice. Similarly, to set up three new clusters, you perform this procedure three times. Each time you perform this procedure, you update the same cluster.properties file before you run the ant command.

To set up each additional cluster

1. Open the cluster.properties file for editing. Modify the port numbers and the cluster number listed in the following parameters; verify that each number is unique across all clusters.

   The defaults listed in these parameters are the initial values for the first node to be created, for later nodes, increment this number so that it is unique. Ideally, increment the port and cluster numbers by 1 from the previous cluster.

   Consider running the Windows netstat command to help identify which ports are available.

   view.node.id=number

   Specifies the number of the cluster.

   The default is 1.

   view.shutdown.port=number

   Specifies the Tomcat shutdown port for this node.

   The default is 8086.

   view.http.port=number

   Specifies the Tomcat startup port for this node.

   The default is 8081.

   view.ajp.port=number

   Specifies the ajp port for the load balancer to communicate with this node.

   The default is 8010.

   view.receiver.port=number

   Specifies the Tomcat cluster receiver node.

   The default is 4003.

2. In Windows Explorer, navigate to %USM_HOME% and double-click the usm.cmd file.

   The CA Service Catalog command prompt is opened, with the location set to the %USM_HOME% folder path.

3. At the CA Service Catalog command prompt, run the following command:

   ant install-view-node
   

   When you run this command for the first time, a new folder named viewn and a new Windows service named CA Service Viewn are created, where the number n is copied from the view.node.id=number parameter in the cluster.properties file.

   For example, if you specified view.node.id=1 in the cluster.properties file, then a new folder named view1 and a new Windows service named CA Service View1 are created. Similarly, when you run this command for the second time, if you specified view.node.id=2 in the cluster.properties file, then a new folder named view2 and a new Windows service named CA Service View2 are created. Likewise, when you update the file again and run this command again each successive time, the new folder and service are named accordingly.

   The ant command makes several configuration changes, including the following changes:

   • Copies several subdirectories of Service View to the new Service View folder: conf\* and webapps\Root\*.
   • Updates the server.xml, viewservice.conf, and Log4j.properties files of all clusters with required configuration changes, including updates of cluster names, port numbers, the jmsclientid, and engine names.
   • Creates a new Windows service and log file for the new cluster.

   For a detailed description of the changes made by the ant command, see Updates Made by the Ant Command.