Unable to remove the Mobility agent host from vSphere Distributed Switch (VDS).
search cancel

Unable to remove the Mobility agent host from vSphere Distributed Switch (VDS).

book

Article ID: 402002

calendar_today

Updated On:

Products

VMware HCX

Issue/Introduction

  • Following error, "Removal of Distributed Virtual Switch (DVS) from vCenter server not allowed as there is at least one ESXi host connected to that DVS" is observed while decommissioning the host cluster from SDDC manager as vSphere Distributed Switch (VDS) removal failed.

  • On navigating to the vCenter UI -> Networking -> VDS (which can be referred from the above error screenshot) -> hosts, Mobility Agent Host was noticed. 

NoteThe Mobility Agent host is required. Deleting this host can disrupt HCX Cold, vMotion, and Replication Assisted vMotion (RAV) migrations.

 

Environment

VMware HCX
VMware vCenter Server

Cause

Mobility agent host was referencing this VDS. This is expected behavior, if cluster decommission is attempted before disabling it from the HCX service mesh. 

Resolution

Please follow the below steps to gracefully remove Mobility agent host. 

  • Make sure no current HCX migrations are in place.
  • Disconnect the Mobility Agent host from vCenter UI and then remove from inventory.
  • Resync the Service Mesh (SM). This will get the Mobility Agent back under vCenter inventory. Refer this doc on how to resync the service mesh.

If the above steps, still don't help - user can recover from the error by removing the Mobility agent host from vCenter VDS.

Additional Information

If Fleet appliances were part of the decommissioned cluster and got moved to another cluster, please refer Migrating HCX Fleet appliances to a different cluster

Refer this to know about Mobility Agent host