Temporarily allow vCenter VMware Update Manager (VUM) to enable the transition of heterogeneous hardware to vLCM image management

Products

• VMware vCenter Server

Issue/Introduction

To complete an upgrade to VCF 9, all clusters must transition from vLCM baseline management (formerly VUM) to vLCM image management. The ESX upgrade portion of the VMware Cloud Foundation 9.x process requires vLCM image-managed clusters as a prerequisite. 

However, vLCM images for heterogeneous hardware-based clusters are only supported starting in ESX 9. This seemingly creates a circular dependency where the transition must occur after the ESX 9 upgrade, but the upgrade normally requires the transition first. To resolve this, a special process is required to temporarily allow the vCenter Update Manager (VUM) service to perform the upgrade to ESX 9 on these specific clusters. 

Environment

• SDDC Manager: 9.0 or later
• vCenter: 9.0 or later
• NSX: 9.0 or later
• ESXi: 8.0.3 or earlier

Cause

The system cannot upgrade to a vLCM Image-managed cluster without first upgrading to ESX 9, but vLCM image management on heterogeneous hardware clusters is not supported until the hosts are already running ESX 9.

Resolution

The vCenter Update Manager service can be unrestricted via a Broadcom-provided PowerShell script or vCenter APIs, provided that one or more heterogeneous-hardware clusters are detected in the inventory.

Important Caveats:

• This process is only supported for true heterogeneous clusters.
• The VUM service becomes restricted again after a service restart or appliance reboot.
• Following VUM-based ESX 9 upgrades, you should prioritize transitioning the clusters to vLCM images immediately. 

Option 1: PowerShell (Preferred)

Requirements:

• Client Software: 
• • • VCF PowerCLI 9.0+

      • Note: Before installing VCF.PowerCLI uninstall VMware.PowerCLI to avoid conflicts between the two modules.

    • PowerShell 7.2+
• User Rights: SDDC Manager ADMIN user.
• Network: HTTPS access to SDDC Manager and vCenter.

Steps:

1. Download the latest release of the Powershell script from the official VMware by Broadcom github repository: VUM Unrestrict Script
2. Unzip VumUnrestrict.zip
3. Run the script: .\VumUnrestrict.ps1
4. When prompted, enter your SDDC Manager FQDN, username, and password.
5. Review the status returned by the script:

Status	Meaning	Action Required
N/A	vCenter version not supported	Upgrade to vCenter 9.0 or later
Unrestricted	Success - VUM Services Unrestricted	Ready to proceed to ESX 9.0 upgrade
Restricted	No heterogeneous clusters located	Transition clusters to vLCM images normally
Failed	vCenter Task failed or blocked	Open a support case

Option 2: API (Using Developer Center)

Requirements:

• User Rights: vCenter Administrative rights.
• Server: vCenter 9.0 or later.
• Network:  HTTPS access to vCenter.

Steps:

1. Log in to the vCenter UI as an administrator.
2. Navigate to Menu > Developer Center > API Explorer.
3. Select the esx API endpoint.
4. Expand settings/inventory.
5. Locate and expand: POST /api/esx/settings/inventory?action=update-vum-capability&vmw-task=true
6. Execute the call. You will receive a Task ID (e.g., "52b3cef6...:com.vmware.esx.settings.inventory"). Copy this ID.
7. Change the API endpoint dropdown to cis.
8. Expand tasks > /api/cis/tasks/{task}.
9. Enter your Task ID into the field and click Execute.
10. Verify the results: If vum_operations_enabled is true, VUM has been successfully unrestricted.

 

Additional Information

Support

For product issues, please open a standard Broadcom support case.

For bugs or enhancement requests with this script, please open a github issue.