JGroups Protocol TCPPING: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
(Created page with "=External= * JGroups Manual http://www.jgroups.org/manual/html/protlist.html#TCPPING * JGroups Wiki http://community.jboss.org/wiki/JGroupsTCPPING =Internal= * JGroups#Pr...")
 
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
=External=
=External=


* JGroups Manual http://www.jgroups.org/manual/html/protlist.html#TCPPING
* JGroups Manual http://www.jgroups.org/manual/html/protlist.html#TCPPING_Prot
* JGroups Wiki http://community.jboss.org/wiki/JGroupsTCPPING
* JGroups Wiki http://community.jboss.org/wiki/JGroupsTCPPING


Line 7: Line 7:


* [[JGroups#Protocols|JGroups]]
* [[JGroups#Protocols|JGroups]]
=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 [[JGroups Protocol GMS|GMS]]' FIND_INITIAL_MBRS event.
=Configuration=
<pre>
    <TCPPING initial_hosts="hosta[2300],hostb[3400],hostc[4500]"
            port_range="3"
            timeout="3000"
            num_initial_members="2"/>
</pre>
==WildFly Configuration==
<pre>
<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>
</pre>
For more details, see:
<blockquote style="background-color: #f9f9f9; border: solid thin lightgrey;">
:[[WildFly JGroups Subsystem Configuration|WildFly JGroups Configuration]]
</blockquote>
=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.

Latest revision as of 22:59, 3 June 2016

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.