Skip to content

Commit 1460939

Browse files
authored
RS: Clarified quorum loss check and warning when activating maintenance mode (#1643)
* DOC-3587 RS: Clarified quorum loss check and warning when activating maintenance mode * DOC-3587 Adjusted wording of maintenance mode quorum check
1 parent bbf39c0 commit 1460939

File tree

3 files changed

+12
-6
lines changed

3 files changed

+12
-6
lines changed

content/operate/rs/7.4/clusters/maintenance-mode.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,11 @@ Use maintenance mode to prevent data loss during hardware patching or operating
1717

1818
When you activate maintenance mode, Redis Enterprise does the following:
1919

20-
1. Checks whether a shut down of the node will cause quorum loss. If so, maintenance mode will not turn on.
20+
1. Checks whether the cluster has enough active nodes to maintain quorum if one goes down. If taking a node offline would cause quorum loss, maintenance mode will not activate.
2121

22-
Maintenance mode does not protect against quorum loss. If you activate maintenance mode for the majority of nodes in a cluster and restart them simultaneously, quorum is lost, which can lead to data loss.
22+
{{<warning>}}
23+
This check does not consider if other nodes are already in maintenance mode. Do not put the majority of nodes into maintenance mode and restart them simultaneously, as this can cause the cluster to lose quorum and lead to data loss.
24+
{{</warning>}}
2325

2426
1. If no maintenance mode snapshots already exist or if you use `overwrite_snapshot` when you activate maintenance mode, Redis Enterprise creates a new node snapshot that records the node's shard and endpoint configuration.
2527

content/operate/rs/7.8/clusters/maintenance-mode.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,11 @@ Use maintenance mode to prevent data loss during hardware patching or operating
1717

1818
When you activate maintenance mode, Redis Enterprise does the following:
1919

20-
1. Checks whether a shut down of the node will cause quorum loss. If so, maintenance mode will not turn on.
20+
1. Checks whether the cluster has enough active nodes to maintain quorum if one goes down. If taking a node offline would cause quorum loss, maintenance mode will not activate.
2121

22-
Maintenance mode does not protect against quorum loss. If you activate maintenance mode for the majority of nodes in a cluster and restart them simultaneously, quorum is lost, which can lead to data loss.
22+
{{<warning>}}
23+
This check does not consider if other nodes are already in maintenance mode. Do not put the majority of nodes into maintenance mode and restart them simultaneously, as this can cause the cluster to lose quorum and lead to data loss.
24+
{{</warning>}}
2325

2426
1. If no maintenance mode snapshots already exist or if you use `overwrite_snapshot` when you activate maintenance mode, Redis Enterprise creates a new node snapshot that records the node's shard and endpoint configuration.
2527

content/operate/rs/clusters/maintenance-mode.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,11 @@ Use maintenance mode to prevent data loss during hardware patching or operating
1616

1717
When you activate maintenance mode, Redis Enterprise does the following:
1818

19-
1. Checks whether a shut down of the node will cause quorum loss. If so, maintenance mode will not turn on.
19+
1. Checks whether the cluster has enough active nodes to maintain quorum if one goes down. If taking a node offline would cause quorum loss, maintenance mode will not activate.
2020

21-
Maintenance mode does not protect against quorum loss. If you activate maintenance mode for the majority of nodes in a cluster and restart them simultaneously, quorum is lost, which can lead to data loss.
21+
{{<warning>}}
22+
This check does not consider if other nodes are already in maintenance mode. Do not put the majority of nodes into maintenance mode and restart them simultaneously, as this can cause the cluster to lose quorum and lead to data loss.
23+
{{</warning>}}
2224

2325
1. If no maintenance mode snapshots already exist or if you use `overwrite_snapshot` when you activate maintenance mode, Redis Enterprise creates a new node snapshot that records the node's shard and endpoint configuration.
2426

0 commit comments

Comments
 (0)