Skip to content

Commit 262ae25

Browse files
authored
Merge pull request #90231 from kowen-rh/osdocs-13517
OSDOCS#13517: Note 4-, 5-node HA clusters in etcd quorum restore docs
2 parents 1f84be0 + d7fe60e commit 262ae25

File tree

2 files changed

+5
-3
lines changed

2 files changed

+5
-3
lines changed

modules/dr-restoring-cluster-state.adoc

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818

1919
You can use a saved etcd backup to restore a previous cluster state or restore a cluster that has lost the majority of control plane hosts.
2020

21-
For high availability (HA) clusters, a three-node HA cluster requires you to shutdown etcd on two hosts to avoid a cluster split. Quorum requires a simple majority of nodes. The minimum number of nodes required for quorum on a three-node HA cluster is two. If you start a new cluster from backup on your recovery host, the other etcd members might still be able to form quorum and continue service.
21+
For high availability (HA) clusters, a three-node HA cluster requires you to shut down etcd on two hosts to avoid a cluster split. On four-node and five-node HA clusters, you must shut down three hosts. Quorum requires a simple majority of nodes. The minimum number of nodes required for quorum on a three-node HA cluster is two. On four-node and five-node HA clusters, the minimum number of nodes required for quorum is three. If you start a new cluster from backup on your recovery host, the other etcd members might still be able to form quorum and continue service.
2222

2323
[NOTE]
2424
====
@@ -108,4 +108,4 @@ If you see no progress rolling out the etcd static pods, you can force redeploym
108108
[source,terminal]
109109
----
110110
$ oc patch etcd cluster -p='{"spec": {"forceRedeploymentReason": "recovery-'"$(date --rfc-3339=ns )"'"}}' --type=merge
111-
----
111+
----

modules/dr-restoring-etcd-quorum-ha.adoc

+3-1
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@
88

99
You can use the `quorum-restore.sh` script to instantly bring back a new single-member etcd cluster based on its local data directory and mark all other members as invalid by retiring the previous cluster identifier. No prior backup is required to restore the control plane from.
1010

11+
For high availability (HA) clusters, a three-node HA cluster requires you to shut down etcd on two hosts to avoid a cluster split. On four-node and five-node HA clusters, you must shut down three hosts. Quorum requires a simple majority of nodes. The minimum number of nodes required for quorum on a three-node HA cluster is two. On four-node and five-node HA clusters, the minimum number of nodes required for quorum is three. If you start a new cluster from backup on your recovery host, the other etcd members might still be able to form quorum and continue service.
12+
1113
[WARNING]
1214
====
1315
You might experience data loss if the host that runs the restoration does not have all data replicated to it.
@@ -155,4 +157,4 @@ It can take up to 15 minutes for the control plane to recover.
155157
[source,terminal]
156158
----
157159
$ oc patch etcd cluster -p='{"spec": {"forceRedeploymentReason": "recovery-'"$(date --rfc-3339=ns )"'"}}' --type=merge
158-
----
160+
----

0 commit comments

Comments
 (0)