From 935f4585d8f0b61a1588fefa4ef251a3c42f2249 Mon Sep 17 00:00:00 2001 From: rajeshvenkata Date: Fri, 14 Nov 2025 14:53:08 -0800 Subject: [PATCH] Add documentation for skip contact check for bmc machines --- .../cluster-upgrades/baremetal-upgrades.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/content/en/docs/clustermgmt/cluster-upgrades/baremetal-upgrades.md b/docs/content/en/docs/clustermgmt/cluster-upgrades/baremetal-upgrades.md index ee3be6501953..069f662bdbf7 100755 --- a/docs/content/en/docs/clustermgmt/cluster-upgrades/baremetal-upgrades.md +++ b/docs/content/en/docs/clustermgmt/cluster-upgrades/baremetal-upgrades.md @@ -84,6 +84,28 @@ eksa-worker2 type=worker-group-1 If you don't have any available hardware that match this requirement in the cluster, you can [setup a new hardware CSV]({{< relref "../../getting-started/baremetal/bare-preparation/#prepare-hardware-inventory" >}}). You can feed this hardware inventory file during the [upgrade cluster command]({{< relref "baremetal-upgrades/#upgrade-cluster-command" >}}). +#### Skip BMC connectivity checks for faulty machines + +EKS Anywhere validates that all BMC machines are contactable before performing cluster upgrades. If you have faulty BMC machines with connectivity issues or hardware faults, you can skip validation for those specific machines so they don't block your cluster upgrade. + +To skip BMC validation for a machine: + +``` +kubectl label machine.bmc.tinkerbell.org \ + -n eksa-system \ + bmc.tinkerbell.org/skip-contact-check=true +``` + +After you have repaired or replaced the faulty hardware and verified that BMC connectivity is restored, remove the skip label to re-enable normal BMC validation for future upgrades: + +``` +kubectl label machine.bmc.tinkerbell.org \ + -n eksa-system \ + bmc.tinkerbell.org/skip-contact-check- +``` + +>**_NOTE:_** The skip label should only be used temporarily during upgrades when a machine has known issues. Once the machine is healthy, remove the label to ensure proper BMC validation in subsequent operations. + ### Performing a cluster upgrade To perform a cluster upgrade you can modify your cluster specification `kubernetesVersion` field to the desired version.