Used in: unicast-listener.


Specifies a list of "well known" addresses to use in forming a cluster.

By default Coherence uses a multicast protocol to discover other nodes when forming a cluster. If multicast networking is undesirable, or unavailable in your environment, the Well Known Addresses feature may be used to eliminate the need for multicast traffic.

Use of the Well Known Addresses (WKA) feature requires a Coherence Enterprise License.

If you are having difficulties in establishing a cluster via multicast, see the Multicast Test.


The following table describes the elements you can define within the well-known-addresses element.

Element Required/Optional Description
<socket-address> Required Specifies a list of "well known" addresses (WKA) that are used by the cluster discovery protocol in place of multicast broadcast. If one or more WKA is specified, for a member to join the cluster it will either have to be a WKA or there will have to be at least one WKA member running. Additionally, all cluster communication will be performed using unicast. If empty or unspecified multicast communications will be used.

Preconfigured overrides are tangosol.coherence.wka and tangosol.coherence.wka.port.

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.