Bug 1475188

Summary: [GSS](6.3.z) jgroups port_range documentation
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: tmiyargi
Component: DocumentationAssignee: eap-docs <eap-docs>
Status: CLOSED DEFERRED QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.3.3CC: ahoffer, eap-docs
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-11-15 19:35:06 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description tmiyargi 2017-07-26 07:54:36 UTC 
Document URL: 
https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html/Administration_and_Configuration_Guide/Configure_the_JGroups_Subsystem_to_Use_TCP.html

Section Number and Name: 
⁠19.4.2. Configure the JGroups Subsystem to Use TCP

Describe the issue: 

port_range is initialport + port_range, as explained here
http://www.jgroups.org/manual/html/user-advanced.html

Suggestions for improvement: 

Additionally, the description of the initial_hosts property in the EAP
documentation is incomplete/misleading:
"A comma-separated list of the hosts which are considered well-known,
and will be available to look up the initial membership."

The value of the initial_hosts property includes a host *and* port
using the syntax: host[port].  The port_range applies to each address
specified in initial_hosts.  The end result is that the port_range
effectively multiplies the set of potential initial members.
e.g.
if initial_hosts="host1[1000],host2[2000]" and port_range="2", TCPPING
will try to contact the following addresses when the channel is
connected:

host1:1000, host1:1001, host1:1002, host2:2000, host2:2001, host2:2002

Additional information: