SDDC Manager ESXi Host Upgrade Fails With Required Product HCX Not Found In BOM
search cancel

SDDC Manager ESXi Host Upgrade Fails With Required Product HCX Not Found In BOM

book

Article ID: 445866

calendar_today

Updated On:

Products

VMware SDDC Manager / VCF Installer

Issue/Introduction

In the SDDC Manager user interface (UI), attempting to select or proceed with an ESXi host upgrade fails. The UI displays the following error messages and reference tokens:

"Fetching the upgrade plan failed. A problem has occurred on the server. Please retry or contact the service provider and provide the reference token. Reference token: 

"Fetching components failed. A problem has occurred on the server. Please retry or contact the service provider and provide the reference token. Reference token:

The following error is observed in the /var/log/vmware/vcf/lcm/lcm-debug.log

YYYY-MM-DDTHH:MM:SS.000+0000 ERROR [vcf_lcm, ] [c.v.e.s.e.h.LocalizableRuntimeExceptionHandler, http-nio-127.0.0.1-7400-exec-10] [#####] VCF_ERROR_INTERNAL_SERVER_ERROR Required product HCX not found in BOM for version check
com.vmware.evo.sddc.common.core.error.InternalServerErrorException: Required product HCX not found in BOM for version check
Caused by: com.vmware.evo.sddc.lcm.model.error.LcmException: "Could not find VMware product version in manifest bom for release: 5.2.4.0 and type: HCX"

Environment

VMware Cloud Foundation 9.1

 

Cause

The upgrade sequences API fails during a straddle-state component upgrade (such as ESXi 8.x to 8.y) if the environment contains VMware HCX and the bill of materials (BOM) validation cannot map the product version within the specific release manifest.

Resolution

To bypass the manifest dependency block, active HCX components and dependencies must be decommissioned before retrying the host lifecycle operations:

  1. Finalize Migrations: Ensure all active virtual machine migrations are completely finalized, stabilized, or canceled.

  2. Remove Network Extensions: Unstretch and remove any active or extended network configurations within HCX.

  3. Delete Service Meshes: Delete any active service mesh configurations deployed across the sites.

  4. Uninstall HCX: Once active dependencies are removed, proceed with the uninstallation of the HCX appliance to clear the lifecycle management block.

  5. Retry Upgrade: Log back into the SDDC Manager UI and re-initiate the ESXi host upgrade plan.

Powered by Wolken Software