[infinispan-issues] [JBoss JIRA] (ISPN-11428) Docs: JGroups Config Updates

[Donald Naro (Jira)]

     [ https://issues.redhat.com/browse/ISPN-11428?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Donald Naro updated ISPN-11428:
-------------------------------
    Description: 
>From Wolf:

ISPN docs
https://infinispan.org/docs/dev/titles/configuring/configuring.html#cluster_transport
show information about improve performance and mention jgroups-default.xml ....
but no idea where to find it

name is confusing should be clarified
there is no jgroups-defaults for the server it is default-configs/default-jgroups-<stack>.xml
there is no infinispan-jgroups.xml as well in core.jar
so the (i) box is just confusion

5. Setting up Cluster Transport
5.1.2 Default stack
Confusing as the default-jgroups-[tcp|udp].xml show something more specific and more attributes.
What is the purpose of this simplified stack? If the default xmls are used I would not include the example here, just point to the ispn-core.jar/default-configs which are listed in 5.1.1

The (i) box is confusing as there is no heint where to find it.
Also the ispn-core.jar does not include a jgroups-default.xml or infinspan-jgroups.xml. The embedded stuff seems to point to the same defaults as 5.1.1.
If there are no real properties which are the default I would remove the box

5.2 inline stack
The hint box “Use inheritance …” should point to 5.3 and here it should mention that this is a fully created stack with the complete configuration.
5.3 Adjusting
For 2. You should mention that this can be “udp” or “tcp” used by default, not only a self created one
Note that <VERIFY_SUSPECT> is replaced, which means all attributes are back to defaults.

Example might include RELAY as it can be used without any position to be appended at the end. This is most useful for XSite replication (example is infnispan-xsite.xml)

Explain that the stack.position is the name of any protocol.
Not sure what happen if it is not found!
5.5.1 system properties default jgroups
UDP
Jgroups.udp.*  → no udp !
Missing
Address → jgroups.bind.address,jgroups.udp.address  defaults to SITE_LOCAL
Port → jgroups.bind.port,jgroups.udp.port defaults to “0” automatically

TCP
Address can use jgroups.bind.address and the default is SITE_LOCAL not 127.0.0.1
Port can use jgroups.bind.port
Jgroups.udp.*  → no udp !

EC2, kubernetes
Same here for address and port
6 Discovery
Should we list FILE_PING as well as this is the simple base for discovery and already shared with customers?


  was:
* Review getting started content for accuracy.
* Fix formatting errors.
* No broken links or anchors. 
* All attributes are correct and up to date. 
* Clean up Dev Guide content. Light review.



> Docs: JGroups Config Updates
> ----------------------------
>
>                 Key: ISPN-11428
>                 URL: https://issues.redhat.com/browse/ISPN-11428
>             Project: Infinispan
>          Issue Type: Enhancement
>          Components: Documentation
>            Reporter: Donald Naro
>            Assignee: Donald Naro
>            Priority: Major
>
> From Wolf:
> ISPN docs
> https://infinispan.org/docs/dev/titles/configuring/configuring.html#cluster_transport
> show information about improve performance and mention jgroups-default.xml ....
> but no idea where to find it
> name is confusing should be clarified
> there is no jgroups-defaults for the server it is default-configs/default-jgroups-<stack>.xml
> there is no infinispan-jgroups.xml as well in core.jar
> so the (i) box is just confusion
> 5. Setting up Cluster Transport
> 5.1.2 Default stack
> Confusing as the default-jgroups-[tcp|udp].xml show something more specific and more attributes.
> What is the purpose of this simplified stack? If the default xmls are used I would not include the example here, just point to the ispn-core.jar/default-configs which are listed in 5.1.1
> The (i) box is confusing as there is no heint where to find it.
> Also the ispn-core.jar does not include a jgroups-default.xml or infinspan-jgroups.xml. The embedded stuff seems to point to the same defaults as 5.1.1.
> If there are no real properties which are the default I would remove the box
> 5.2 inline stack
> The hint box “Use inheritance …” should point to 5.3 and here it should mention that this is a fully created stack with the complete configuration.
> 5.3 Adjusting
> For 2. You should mention that this can be “udp” or “tcp” used by default, not only a self created one
> Note that <VERIFY_SUSPECT> is replaced, which means all attributes are back to defaults.
> Example might include RELAY as it can be used without any position to be appended at the end. This is most useful for XSite replication (example is infnispan-xsite.xml)
> Explain that the stack.position is the name of any protocol.
> Not sure what happen if it is not found!
> 5.5.1 system properties default jgroups
> UDP
> Jgroups.udp.*  → no udp !
> Missing
> Address → jgroups.bind.address,jgroups.udp.address  defaults to SITE_LOCAL
> Port → jgroups.bind.port,jgroups.udp.port defaults to “0” automatically
> TCP
> Address can use jgroups.bind.address and the default is SITE_LOCAL not 127.0.0.1
> Port can use jgroups.bind.port
> Jgroups.udp.*  → no udp !
> EC2, kubernetes
> Same here for address and port
> 6 Discovery
> Should we list FILE_PING as well as this is the simple base for discovery and already shared with customers?



--
This message was sent by Atlassian Jira
(v7.13.8#713008)