...
| Table of Contents | ||||
|---|---|---|---|---|
|
Clustering agent
The clustering agent is responsible for initializing the nodes in a cluster and for all clustering-related functionality. The default clustering agent is from Hazelcast Community Edition (org.wso2.carbon.core.clustering.hazelcast.HazelcastClusteringAgent).
...
| Parameter | Description |
|---|---|
AvoidInitiation | Prevents the cluster from being initialized automatically when the AxisConfiguration is built. By default, this parameter is set to true, because Carbon initializes the cluster after the server and transports have been fully started. |
membershipScheme | The membership scheme that will be used to manage membership of nodes in a cluster. You can set this parameter to
|
domain | The clustering domain/group. Note that the words "domain" and "group" are used synonymously. There will not be any interference between nodes in different groups. Messages received from members outside the group will generally be ignored. However, special messages, such as cluster management messages or membership messages from members outside the group, will be allowed. |
mcastAddress | The multicast address to be used. This parameter will only be taken into consideration when membershipScheme is set to multicast. |
mcastPort | The multicast port to be used. This parameter will only be taken into consideration when membershipScheme is set to multicast. |
mcastTTL | Controls the scope of multicasts by defining the default time-to-live for multicast packets that are sent out. Defaults to 32 with a maximum of 255. |
mcastTimeout | Specifies the time in seconds that a node should wait for a valid multicast response from another node running in the network before declaring itself as master node and creating its own cluster. This applies only to the startup of nodes where no master has been assigned yet. For example, if you set this property to 60 seconds, until a master is selected each node will wait 60 seconds before continuing. Therefore, a high value can negatively impact performance, but if the value is set too low, nodes might give up too early and will create their own cluster. Defaults to 2 seconds. |
memberDropTime | The time interval in milliseconds to wait for a member to respond before it is deemed to have left the group and is dropped. |
mcastBindAddress | The IP address of the network interface to which the multicasting is bound. This parameter will only be taken into consideration when membershipScheme is set to multicast. Note that this can be different from the localMemberHost parameter, so the cluster can listen for point-to-point messages on the localMemberHost network interface while listening for multicast messages on the network interface bound to the mcastBindAddress. |
localMemberHost | The host name or IP address of this member. This is the IP address advertised by this member when it joins the group and sends messages. This should be set to a valid value other than localhost or 127.0.0.1. In most cases, you can set it to the IP address bound to the network interface that is used for communicating with members in the group. |
localMemberPort | The TCP port used by this member and through which other members will contact this member. |
properties | Name-value pairs specific to this member. When a member joins a group, these properties are bound to this member so that other members in the group can detect these properties. The properties backendServerURL and mgtConsoleURL are used for cluster management. The backendServerURL property is used to connect to the back-end management Web services of this member using the front end of the cluster manager. Similarly, if this member wants to expose its own management console, it can do so by providing the mgtConsoleURL property. The backendServerURL property is specified using the <property name="backendServerURL" value="https://${hostName}:${httpsPort}/services/"/> entry, where ${hostName} represents the hostName member property and ${httpsPort} represents the httpsPort member property, both of which are implicit member properties. (The httpPort property is another implicit member property.) Properties that have been previously declared can be used in subsequent property definitions. For example, you can define a new property as follows: <property name="foo" value="${backendServerULR}/foo"/> |
| Anchor | ||||
|---|---|---|---|---|
|
Group management
If you are not using the WSO2 ELB to front a cluster of service-based products (such as WSO2 ESB, Data Services Server, and Application Server), enable the groupManagement element when a member is deployed as a cluster manager. A group management agent, which is an instance of the org.wso2.carbon.core.clustering.hazelcast.HazelcastGroupManagementAgent interface, must be specified for each group (applicationDomain) that is being managed. The following example configuration shows how cluster management has been enabled for group1 and group2:
| Code Block |
|---|
<groupManagement enable="true">
<applicationDomain name="group1"
description="This is the first group"
agent="org.wso2.carbon.core.clustering.hazelcast.HazelcastGroupManagementAgent"
subDomain="worker"
port="2222" />
<applicationDomain name="group2"
description="This is the second group"
agent="org.wso2.carbon.core.clustering.hazelcast.HazelcastGroupManagementAgent"
subDomain="worker"
port="2233" />
</groupManagement> |
Static members
The members element is used for specifying static or well-known members. You must specify the host name and primary port of each member. The following sample member configuration shows two static members with different IP addresses and ports:
...