openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Code Issues Releases Activity

OSDOCS-17158: node replacement procedure

Browse Source
This commit is contained in:
Sebastian Kopacz
2025-11-10 15:05:15 -05:00
committed by openshift-cherrypick-robot
parent ab54742a45
commit 3aa7285490
9 changed files with 819 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
nodes/nodes/nodes-nodes-replace-control-plane.adoc Normal file
View File

@@ -0,0 +1,39 @@
:_mod-docs-content-type: ASSEMBLY
[id="replacing-control-plane-node"]
= Replacing a failed bare-metal control plane node without BMC credentials
include::_attributes/common-attributes.adoc[]
:context: replacing-control-plane-node
toc::[]
If a control plane node on your bare-metal cluster has failed and cannot be recovered, but you installed your cluster without providing baseboard management controller (BMC) credentials, you must take extra steps in order to replace the failed node with a new one.
// Prerequisites
include::modules/nodes-replace-control-plane-prereqs.adoc[leveloffset=+1]
// Removing the unhealthy etcd member
include::modules/nodes-remove-unhealthy-etcd-member.adoc[leveloffset=+1]
// Deleting the machine of the unhealthy etcd member
include::modules/nodes-delete-machine-unhealthy-etcd.adoc[leveloffset=+1]
// Verifying that the failed node was deleted
include::modules/nodes-verify-failed-node-deleted.adoc[leveloffset=+1]
// Creating the new control plane node
include::modules/nodes-create-new-control-plane-node.adoc[leveloffset=+1]
// Linking the node, bare metal host, and machine together
include::modules/nodes-link-node-machine-bmh.adoc[leveloffset=+1]
// Adding the new etcd member
include::modules/nodes-add-new-etcd-member.adoc[leveloffset=+1]
[role="_additional-resources"]
[id="additional-resources_{context}"]
== Additional resources
* xref:../../backup_and_restore/control_plane_backup_and_restore/replacing-unhealthy-etcd-member.adoc#restore-replace-stopped-baremetal-etcd-member_replacing-unhealthy-etcd-member[Replacing an unhealthy bare metal etcd member whose machine is not running or whose node is not ready]
* xref:../../backup_and_restore/control_plane_backup_and_restore/replacing-unhealthy-etcd-member.adoc#restore-replace-crashlooping-etcd-member_replacing-unhealthy-etcd-member[Replacing an unhealthy etcd member whose etcd pod is crashlooping]
* link:https://access.redhat.com/solutions/6471021[BareMetalHost reference is missing after adding a host to OpenShift Assisted Installer cluster (Red{nbsp}Hat KCS article)]
* link:https://access.redhat.com/solutions/5504291[How to retrieve Master or Worker Ignition Configuration from {product-title} 4? (Red{nbsp}Hat KCS article)]