Used in: cluster-config.
The TCP-ring provides a means for fast death detection of another node within the cluster. When enabled the cluster nodes form a single "ring" of TCP connections spanning the entire cluster. A cluster node is able to utilize the TCP connection to detect the death of another node within a heartbeat interval (default one second). If disabled the cluster node must rely on detecting that another node has stopped responding to UDP packets for a considerately longer interval. Once the death has been detected it is communicated to all other cluster nodes.
The following table describes the elements you can define within the tcp-ring-listener element.
Element | Required/Optional | Description |
---|---|---|
<enabled> | Required | Specifies whether the tcp ring listener should be enabled to defect node failures faster.
Legal values are true and false. Default value is true. Preconfigured override is tangosol.coherence.tcpring |
<maximum-socket-closed-exceptions> | Required | Specifies the maximum number of tcp ring listener exceptions that will be tolerated before a particular member is considered really gone and is removed from the cluster.
This value is used only if the value of tcp-ring-listener/enabled is true. Legal values are integers greater than zero. Default value is 2. |
<priority> | Required | Specifies a priority of the tcp ring listener execution thread.
Legal values are from 1 to 10. Default value is 6. |
The content override attribute xml-override can be optionally used to fully or partially override the contents of this element with XML document that is external to the base document.