diff --git a/docs/modules/clients/pages/java.adoc b/docs/modules/clients/pages/java.adoc index 9ac816c93..5b283f8f1 100644 --- a/docs/modules/clients/pages/java.adoc +++ b/docs/modules/clients/pages/java.adoc @@ -932,6 +932,7 @@ When using the `SINGLE_MEMBER` cluster routing mode, consider the following: connections to the xref:cp-subsystem:cp-subsystem.adoc[CP Subsystem] are direct-to-leader, which can result in improved performance. If leadership is reassigned while using `SINGLE_MEMBER` cluster routing, then this benefit may be lost. * <> configuration is ignored +* xref:thread-per-core-tpc.adoc[Thread-Per-Core] is not supported for `SINGLE_MEMBER` cluster routing and no benefit will gained by enabling it with this routing mode. Declarative Configuration: @@ -993,6 +994,8 @@ is present on your Enterprise cluster, then clients in this routing mode can use to group leaders wherever possible, even after leadership changes. * Best efforts are made to route operations to the required member, but if this cannot be done operations are routed as defined in the <> +* xref:thread-per-core-tpc.adoc[Thread-Per-Core] is not supported for `MULTI_MEMBER` cluster routing and may lead to event inconsistency if used. + Declarative Configuration: [tabs] diff --git a/docs/modules/cluster-performance/pages/thread-per-core-tpc.adoc b/docs/modules/cluster-performance/pages/thread-per-core-tpc.adoc index 50ffa0646..906ee81ae 100644 --- a/docs/modules/cluster-performance/pages/thread-per-core-tpc.adoc +++ b/docs/modules/cluster-performance/pages/thread-per-core-tpc.adoc @@ -15,7 +15,7 @@ A Thread-Per-Core (TPC) design uses one thread for every CPU core and every thre When TPC is enabled, clients using the `ALL_MEMBERS` cluster routing mode connect to the number of cores specified in the client config. If TPC is enabled on both client and server, clients connect directly to one of the TPC threads instead of using the legacy network threads. TPC-enabled servers continue to use the same ports for discovery, which means there's no difference in how the cluster member list is created and TPC-aware servers are backward compatible with clients that don't use TPC. -NOTE: Clients using the `SINGLE_MEMBER` cluster routing mode ignore TPC and connect to a random member in the cluster. Your clients must use the `ALL_MEMBERS` cluster routing mode with TPC. For further information on the `ClientTpcConfig` class used to specify the number of cores to use for connections, refer to https://docs.hazelcast.org/docs/{full-version}/javadoc/com/hazelcast/client/config/ClientTpcConfig.html[Class ClientTpcConfig] in the Java API documentation. +NOTE: Clients using the `SINGLE_MEMBER` or `MULTI_MEMBER` cluster routing modes cannot use TPC. Your clients must use the `ALL_MEMBERS` cluster routing mode with TPC. For further information on the `ClientTpcConfig` class used to specify the number of cores to use for connections, refer to https://docs.hazelcast.org/docs/{full-version}/javadoc/com/hazelcast/client/config/ClientTpcConfig.html[Class ClientTpcConfig] in the Java API documentation. [[tpc-config]] == Configuration Options