My webMethods Server 10.3 | My webMethods Server Webhelp | Administering My webMethods Server | My webMethods Administrator Functions | My webMethods Server Clustering | Working with the cluster.xml File
 
Working with the cluster.xml File
 
Editing the cluster.xml File
Backing Out of a Change to the cluster.xml File
The cluster.xml file contains configuration information for a standalone server or for all servers in a cluster. This file resides in the My webMethods Server database. My webMethods Server adds new servers to this file when you add nodes to a cluster, and modifies it when you make changes in the Cluster Administration page. You can also modify the cluster.xml file manually, as shown in Renaming a Node and Deleting a Node from a Cluster.
The following fragment shows a basic configuration for a node in a cluster:
<Component class="com.webmethods.portal.system.cluster.impl.Server"
   enabled="true"
   name="server-one-node59581">
   <Properties host="server-one" name="http port="8585"/>
   <Properties host="server-one" name="https" port="0"/>
   <Role name="autodeploy"/>
   <Role name="taskengine"/>
   <Role name="notification"/>
</Component>
The following table lists the properties, included in the sample fragment and describes their sample values:
Property
Example value
Node name
server-one-node59581
Host name
server-one
HTTP port
8585
HTTPS port
0—Indicates the HTTPS listener is disabled.
Roles
Indicates the cluster roles supported by this server are autodeploy, taskengine, and notification.
The following table lists the tasks that you perform by modifying the cluster.xml file:
Action
Description
Add a node
Add a complete <Component> element to the file, as shown in the preceding example. In this case, the node must already exist and must use the same My webMethods Server database as other nodes in the cluster. The node name in the cluster.xml file must agree with the node name in the custom_wrapper.conf file on the host machine for that node, or must be specified in the command line used to start the node: mws -n nodeName start
Rename a node
Change the node name of a node.
Modify node attributes
Edit any of the attributes for a node, including node name, HTTP, and HTTPS ports, and cluster roles.
Delete a node
Remove the complete <Component> element that defines the node.
Modify cluster configuration
Edit the cluster properties, described in the cluster properties table.
The following table lists the cluster properties, you can configure using the cluster.xml file:
Property
Description
frontEndUrl
The URL for the My webMethods Server cluster. Specify a fully qualified URL, for example: http://host_name:port_number, or https://host_name:port_number. The default value is the URL of the first node of the cluster.
frontEndSecurePort
The HTTPS port that the My webMethods Server cluster uses for secure communication. The default value is -1, which means that no secure port is configured.
distributedEventsEnabled
Enable or disable the distribution of JMS events between the nodes of a cluster. Valid values are:
*true - enables JMS communication between the nodes in a cluster. Must be set to true for clustered environments.
*false - disables JMS communication between cluster nodes. Use for standalone My webMethods Server instances only.
The default value for a clustered environment is true.