JGroups Protocol TCPPING

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

External

Internal

Overview

A discovery protocol that retrieves the initial membership by connecting directly over TCP connections to statically configured members and sending point-to-point membership requests. The responses are intended to allow the member to determine the coordinator it needs to contact, in order to join the group.

The protocol initiates initial member discovery upon receiving GMS' FIND_INITIAL_MBRS event.

Configuration

    <TCPPING initial_hosts="hosta[2300],hostb[3400],hostc[4500]"
             port_range="3"
             timeout="3000"
             num_initial_members="2"/>

WildFly Configuration

<stack name="tcp">
    ...
    <protocol type="TCPPING">
        <property name="initial_hosts">1.2.3.4[7600],1.2.3.5[7600]</property>
        <property name="num_initial_members">2</property>
        <property name="port_range">0</property>
        <property name="timeout">2000</property>
    </protocol>
       ...
</stack>

For more details, see:

WildFly JGroups Configuration

Configuration Elements

initial_hosts

Comma delimited list of hosts to be contacted for initial membership. The list can be incomplete, as long as at least one of the live members of the group will be included.

Each element consists in the IP address (or resolvable host name) and the TCP transport layer port, specified between brackets.

num_initial_members

Minimum number of initial members to get a response from. Default is 2.

port_range

Number of ports to be probed for initial membership. Default is 1.

timeout

Timeout to wait for the initial members. Default is 3000 ms.