Open sylwiaszunejko opened 10 months ago
I would like to report an issue in page: https://github.com/scylladb/java-driver/blob/085dd34ef46b1de5111629bdccfe4056c4355676/manual/load_balancing/README.md
In TokenAwarePolicy section, there is no mention of the ReplicaOrdering field and when it should be set to ReplicaOrdering.NEUTRAL. This information is covered here: https://github.com/scylladb/java-driver/blob/085dd34ef46b1de5111629bdccfe4056c4355676/driver-core/src/main/java/com/datastax/driver/core/policies/TokenAwarePolicy.java#L90-L98. Although it states that it is important for the LatencyAwarePolicy, in reality, the RackAwareRoundRobinPolicy also does not function correctly without this option.
TokenAwarePolicy
ReplicaOrdering
ReplicaOrdering.NEUTRAL
LatencyAwarePolicy
RackAwareRoundRobinPolicy
Lack of this information in the docs is causing a problem in cassandra-stress (https://github.com/scylladb/java-driver/issues/255#), which is currently being addressed by adding ReplicaOrdering.NEUTRAL to the TokenAwarePolicy (https://github.com/scylladb/scylla-tools-java/pull/367).
cassandra-stress
beside the docs, I think a warning of misuse might be in order...
I would like to report an issue in page: https://github.com/scylladb/java-driver/blob/085dd34ef46b1de5111629bdccfe4056c4355676/manual/load_balancing/README.md
Problem
In
TokenAwarePolicy
section, there is no mention of theReplicaOrdering
field and when it should be set toReplicaOrdering.NEUTRAL
. This information is covered here: https://github.com/scylladb/java-driver/blob/085dd34ef46b1de5111629bdccfe4056c4355676/driver-core/src/main/java/com/datastax/driver/core/policies/TokenAwarePolicy.java#L90-L98. Although it states that it is important for theLatencyAwarePolicy
, in reality, theRackAwareRoundRobinPolicy
also does not function correctly without this option.Lack of this information in the docs is causing a problem in
cassandra-stress
(https://github.com/scylladb/java-driver/issues/255#), which is currently being addressed by addingReplicaOrdering.NEUTRAL
to theTokenAwarePolicy
(https://github.com/scylladb/scylla-tools-java/pull/367).