Skip to content

Commit 084892b

Browse files
Correct k8s rebalance delay advice [CTT-820] (#2090)
`configuring-persistence` conflicted with `kubernetes-persistence` when discussing `rebalance-delay-seconds` usage. The correct advice is from `kubernetes-persistence`. Fixes https://hazelcast.atlassian.net/browse/CTT-820
1 parent aa74a46 commit 084892b

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

docs/modules/storage/pages/configuring-persistence.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -195,14 +195,12 @@ partial-start automatically on the members that have either the most recent or m
195195

196196
You can make a cluster wait for a period of time before repartitioning after one or more members fail to rejoin. When a cluster stores lots of persisted data, it may take a long time to repartition the data after a member leaves the cluster. But, you may expect members to shut down and restart quickly, in which case the cluster doesn't need to repartition the data as soon as a member leaves. You can delay repartitioning for as long as you expect members to rejoin the cluster.
197197

198-
For example, you may want to delay repartitioning when you're running a cluster on Kubernetes and expect members to be restarted quickly.
199-
200-
NOTE: If you're planning a cluster-wide shutdown, you also can stop members from repartitioning by putting the cluster in a `FROZEN` state. See xref:maintain-cluster:cluster-member-states.adoc[].
201-
202198
To delay repartitioning during a single member failure, configure a _rebalance delay_, using the <<persistence-rebalance-delay-seconds, `rebalance-delay-seconds`>> option.
203199

204200
WARNING: If your cluster also stores in-memory data that is not persisted, do not configure a rebalance delay. Clusters do not repartition in-memory data if a member rejoins within the delay. As a result, any data that is not persisted will be lost if the member restarts within the delay, including backups.
205201

202+
WARNING: If you are running Hazelcast on Kubernetes, do not configure a rebalance delay. See xref:kubernetes:kubernetes-persistence.adoc[] for guidance.
203+
206204
Consider the following scenario:
207205

208206
* A cluster consists of members A, B, and C with Persistence enabled.
@@ -219,6 +217,8 @@ If member B does not restart within the rebalance delay, the cluster recovers me
219217
repartitions the data among the remaining members (members A and C
220218
in this case). If member B is later restarted, it recovers its persisted data from disk and brings it up-to-date with data from members A and C. If Merkle trees are enabled on available data structures, members use those to request only missing persisted data. For details about how members use Merkle trees, see <<synch-data, Synchronizing Persisted Data Faster>>.
221219

220+
NOTE: If you are planning a cluster-wide shutdown, you also can stop members from repartitioning by putting the cluster in a `FROZEN` state. See xref:maintain-cluster:cluster-member-states.adoc[].
221+
222222
[[sync-data]]
223223
== Synchronizing Persisted Data Faster
224224

0 commit comments

Comments
 (0)