Management Domain Upgrade Option for vCenter and NSX Greyed Out in VCF 9.1

Products

• VMware SDDC Manager / VCF Installer
• VMware Cloud Foundation

Issue/Introduction

In VMware Cloud Foundation (VCF) 9.1,  the SDDC Manager UI gives the below issue:

• The Upgrade option for vCenter (VC) and NSX in the Management Domain is greyed out.
• The Edit Plan and Cancel Plan buttons are greyed out.

Environment

VMware Cloud Foundation 9.1

Cause

This issue occurs due to stale target upgrade version metadata retained within a domain. Specifically, if the Target VCF Version recorded in the SDDC Manager database is lower than the current Source VCF Version, the UI prevents further upgrade actions or plan modifications.

Resolution

To resolve this, identify and delete the stale domain release entry using the SDDC Manager API. 

1. Identify the Stale Entry:
   1. Log in to the VCF Operations UI.
   2. Navigate to Developer Center > API & SDKs.
   3. Open the SDDC Manager API Explorer.
   4. Locate the TargetUpgradeVersion section.
   5. Execute the following GET call:

      GET /v1/releases/domains

      The output will look like the example below:

      JSON
      {
          "domainId": "5######3-3##3-4##7-a##d-f#########0d",
          "targetVersion": "9.0.2.0",
          "targetSddcManagerVersion": "9.0.2.0.25151285",
          "patches": [
              {
                  "productType": "SDDC_MANAGER",
                  "version": "9.0.2.0.25151285"
              }
          ],
          "isCustomizedBom": false
      }

   6. Review the JSON output to find the domain with the stale targetVersion. Example: If your current version is 9.1 but a domain shows a targetVersion of 9.0.2.0, that entry is stale as shown in the above example.
2. Delete the Stale Entry:
   1. Copy the domainId associated with the stale targetVersion identified in the previous step.
   2. In the same API Explorer section, locate the DELETE call:

      DELETE /v1/releases/domains/{domainId}

   3. Enter the domainId (e.g., 5######3-3##3-4##7-a##d-f4#########d) in the parameter field.
   4. Click Execute.
3. Verify the Fix:
   1. Navigate back to the Inventory > Workload Domains section in SDDC Manager.
   2. Select the affected domain and go to the Updates/Patches tab.
   3. The option to upgrade for vCenter and ESXi should now be available.