VCF Cluster Expansion fails with error: "PortGroup Configuration Mismatch Detected For VDS"

Products

• VCF Operations
• VMware SDDC Manager / VCF Installer

Issue/Introduction

• VMware Cloud Foundation (VCF) cluster expansion fails during the network validation phase due to a portgroup mismatch. The SDDC Manager UI and logs report the following error:

  Message: PortGroup configuration mismatch detected for VDS [<Cluster_name>] in cluster
  Remediation Message: Sync the VDS configuration between vCenter and SDDC Inventory by using the remediate API /v1/clusters/remediations to ensure consistency for cluster <Cluster_name>. Please check logs for more details.

• vCenter and SDDC Manager inventory do not match for Distributed Virtual Portgroups.
• Cluster tasks remain in a failed or non-compliant state.

Environment

VMware Cloud Foundation 9.x
VMware SDDC Manager 9.x

 

Cause

Network configuration in vCenter Server has a discrepancy with the inventory database in VCF SDDC Manager. This typically occurs when changes are made directly in vCenter Server ("out-of-band") rather than through the SDDC Manager workflow

Resolution

Follow these steps to synchronize the SDDC Manager inventory with vCenter:

1. Log in to VCF Operations using administrator credentials.
2. Navigate to Inventory in the left-hand pane and select the affected Workload Domain.
3. Select the Actions menu and click Sync Inventory.
4. If the sync task does not resolve the issue, retrieve the unique identifier (UUID) for the cluster you wish to remediate by executing a GET request to the /v1/clusters endpoint.
   

   GET /v1/clusters

5. Locate the cluster by its name in the returned payload and copy the id field.
6. Run the remediation task using POST:

   POST /v1/clusters/{clusterId}/remediations

7. Verify the task status in the SDDC Manager UI.
8. Retry the cluster expansion operation.