SDDC Manager backup fails with KeyError: 'name' during metadata export phase
search cancel

SDDC Manager backup fails with KeyError: 'name' during metadata export phase

book

Article ID: 440904

calendar_today

Updated On:

Products

VMware SDDC Manager / VCF Installer

Issue/Introduction

SDDC Manager file-based backups fail during the metadata export phase. The SDDC Manager user interface displays the error: "Backup operation failed for SDDC Manager System Configuration. Exporting SDDC Manager metadata operation failed."

Review of the SDDC Manager Supportability and Serviceability (SOS) logs located at /var/log/vmware/vcf/sddc-support/backup-<DATE>/sos.log reveals a failed HTTP GET request to the local inventory endpoint for Distributed Virtual Switches (vdses) on the management cluster, followed by a Python runtime exception:

YYYY-MM-DDT00:00:00.000+0000 INFO [vcf_sos] [restutil.py::get::139::backup-#####-#####-###-###-########] URL GET: http://localhost/v1/clusters/<CLUSTER_ID>/vdses
YYYY-MM-DDT00:00:00.000+0000 INFO [vcf_sos] [restutil.py::get::147::backup-#####-#####-###-###-########] Reason:  
YYYY-MM-DDT00:00:00.000+0000 INFO [vcf_sos] [restutil.py::get::151::backup-#####-#####-###-###-########] Status code: 200
YYYY-MM-DDT00:00:00.000+0000 ERROR [vcf_sos] [sddcmanagerbackup.py::export_metadata::287::backup-#####-#####-###-###-########] 'name'
YYYY-MM-DDT00:00:00.000+0000 ERROR [vcf_sos] [sddcmanagerbackup.py::export_metadata::287::backup-#####-#####-###-###-########] Traceback (most recent call last): File "backup/sddcmanagerbackup.py", line 259, in export_metadata KeyError: 'name'

Environment

 

  • VMware Cloud Foundation (VCF) 5.x

  • VMware Cloud Foundation (VCF) 9.x

 

Cause

The backup script suffers a parsing failure due to an out-of-sync inventory state between SDDC Manager and vCenter Server where a new vSphere Distributed Switch (VDS) was manually added directly to the management vCenter Server topology outside of SDDC Manager workflows.

Resolution

To resolve this issue please apply the following steps: 

 

  1. Log into the SDDC Manager user interface.

  2. Navigate to Inventory > Workload Domains and select the affected Management Workload Domain.

  3. Select the Services tab, click the three dots next to the management vCenter Server, and initiate a manual Inventory Sync.

  4. Monitor the synchronization task until it reports a successful status.

  5. Verify that all vSphere Distributed Switches are now correctly enumerated within the SDDC Manager network inventory view.

  6. Navigate to Backups and re-run the SDDC Manager system backup task.