Resolving Host Commissioning Failure in VCF SDDC Due to ESXi Version Mismatch When Vendor-Specific ISOs Are Unavailable

Products

• VMware vSphere ESXi

Issue/Introduction

Host commissioning in VMware Cloud Foundation (VCF) may fail when the ESXi build version on the host does not match the VCF Bill of Materials (BOM) requirement. This article outlines the resolution for this mismatch when a specific vendor-customized ISO for the required patch level is unavailable.

Environment

• VMware Cloud Foundation (VCF) 5.2.3.0
• ESXi 8.0U3
• Host imaged with a vendor-customized ISO (e.g., Dell 8.0U3i)

Cause

SDDC Manager enforces strict version validation against the VCF BOM. The commissioning validation fails if the host's ESXi build version is not in the supported manifest, even if the base VCF version matches. This is common when a vendor-customized ISO is used that aligns with the base version but does not meet the exact patch level mandated by the VCF BOM.

Resolution

To resolve this mismatch, patch the ESXi host to the supported build level using the VMware vanilla patch ZIP file.

Steps to Remediate

1. Identify the required ESXi build number from the VCF BOM for your specific VCF environment.
2. Download the corresponding VMware vanilla patch ZIP file from the Broadcom Support Portal.
3. Apply the patch to the target host according to the steps in Upgrading, updating or applying a patch to ESXi host using esxcli command
4. Once the host is patched to the supported version and rebooted, return to the SDDC Manager UI and retry the host commissioning task.

The validation task should now pass as the host build version will match the supported VCF BOM.

Additional Information

Commission of host fails on validation - < hostname> Host ESXi version - <version> is not supported. VCF supported ESXi versions - [<version> , <version>]