Hi,
For the channelStartOptions attribute of SimpleTcpCluster, the Tomcat 8.5
documentation notes,
"To start a channel without multicasting, you would want to use the
value Channel.SND_RX_SEQ
| Channel.SND_TX_SEQ that equals to 3."

However, according to 9.0 and later documentation,
"When using the static membership service
org.apache.catalina.tribes.membership.StaticMembershipService you must
ensure that this attribute is configured to use the default value."

I had originally asked this question on the user mailing list
https://marc.info/?l=tomcat-user&m=170241211113364&w=2 which
ch...@christopherschultz.net was kind to answer.
Option 15 (the default) includes option 3. I know this sounds trivial when
spelled-out, however, as a new Tomcat user, the explanation was really
helpful.

Therefore, I would like to propose that the documentation for 9.0 and later
versions be elaborated to,
"When using the static membership service
org.apache.catalina.tribes.membership.StaticMembershipService (or the
static membership interceptor
org.apache.catalina.tribes.group.interceptor.StaticMembershipInterceptor)
you must ensure that this attribute is configured to include the value
Channel.SND_RX_SEQ | Channel.SND_TX_SEQ = 3 which the default value (15)
does. This is because static membership exclusively uses unicast."
I know this is more verbose than the previous versions, but imo it's much
clearer.
If this is fine, I would like to raise a PR on GitHub for the change.

Sincerely,
Manak Bisht

Reply via email to