Skip to content

Commit

Permalink
Add warning information for max-concurrent-invocations [DOCS-893] (#…
Browse files Browse the repository at this point in the history
…1141)

Following on-site visit with a customer today, we identified a need to
add more information to the documentation for
`max-concurrent-invocations` regarding the negative consequences of
using it.

Fixes https://hazelcast.atlassian.net/browse/DOCS-893
  • Loading branch information
JamesHazelcast committed Jun 21, 2024
1 parent 681a732 commit defdff1
Showing 1 changed file with 3 additions and 1 deletion.
4 changes: 3 additions & 1 deletion docs/modules/wan/pages/tuning.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -612,10 +612,12 @@ ordering, when these entries are added, is not necessary.
Keep in mind that if you set this element to a value which is less than the target endpoint count,
you will lose performance as not all target endpoints will be used at any point in time to process the WAN event batches.
So, for instance, if you have a target cluster with 3 members (target endpoints) and you want to use
this element, it only makes sense to set it to a value higher than 3. Otherwise, you can simply disable it by
this element, it makes sense to set it to a value equal to or greater than 3. Otherwise, you can simply disable it by
setting it to less than 2 in which case WAN will use the default replication strategy and adapt to
the target endpoint count while maintaining causality.

NOTE: Configuring the `max-concurrent-invocations` to a value greater than 1 will improve WAN replication speed, but this will be a trade-off for higher CPU consumption as more threads are involved in WAN replication. If your replication setup is not saturating WAN queues (so there is no demand for faster WAN replication) then this functionality should not be used as serial replication will be sufficient without additional overhead or out-of-order risks.

An example WAN replication configuration using the default values of
the aforementioned elements is shown below.

Expand Down

0 comments on commit defdff1

Please sign in to comment.