Mismatch for the SDDC Manager VM Name in the SDDC Manager Inventory and the vCenter Inventory Causes an Upgrade Failure

Products

• VMware Cloud Foundation 5.x
• VMware Cloud Foundation
• VMware Cloud Foundation 4.x
• VMware SDDC Manager

Issue/Introduction

During an upgrade process for SDDC Manager, specifically for the Common Application Platform (CAP) stage, the upgrade fails with errors related to the inability to find the SDDC Manager VM in the inventory.

The issue is evident from logs indicating that the task "add-disk" failed due to the missing VM.

 

Found in sos log bundle:

sos-<Time-Stamp>/sddc/var/log/vmware/capengine/cap-required-hardware-addition/workflow.log:

Date/time resource_plugin.go:123: Failed to get details for vm <SDDC Manager's VM name>. Error: vm could not be found
Date/time workflow_manager.go:198: Task add-disk failed. Error: vm could not be found
Date/time workflow_manager.go:138: Stopping workflow execution as task add-disk failed

Environment

VMware Cloud Foundation 4.x

VMware Cloud Foundation 5.x

 

Cause

The failure occurs because there is a mismatch between the SDDC Manager VM name listed in the vCenter Inventory and the one recorded in the SDDC Manager Inventory.

This discrepancy causes the upgrade process to fail as it cannot locate the required VM for further steps.

Resolution

1. Identify the Correct VM Name :
   Determine the correct name of the SDDC Manager VM that is recorded in the SDDC Manager inventory.
2. Edit the VM Name in vCenter :
   • Open the vCenter Inventory and locate the SDDC Manager VM.
   • Edit the VM's properties to match the exact name as it appears in the SDDC Manager inventory, ensuring the case (upper/lower) matches precisely.
     
     
3. Change Case if Necessary :
   If the name discrepancy involves case sensitivity, ensure that you change the VM’s name from uppercase to lowercase or vice versa to match the required format exactly.

Additional Information

• This issue typically arises when there has been an inadvertent change in the SDDC Manager VM's name within the vCenter Inventory.
• The upgrade process is sensitive to the exact naming convention used by both inventories and any mismatch can halt the operation at critical stages such as the Common Application Platform step.