How to clean up an orphaned vCenter Server in VMware Cloud Foundation

Products

• VMware Cloud Foundation

Issue/Introduction

During a workload domain deletion, the vCenter appliance of that workload does not get removed from the PSC appliances and is left in an orphaned state.

Resolution

To resolve this issue, remove references to the orphaned vCenter Server instance from the platform service controller and delete the orphaned vCenter Server virtual machine if it is still in the vSphere inventory.

1. Log in as root to the appliance shell of the Platform Services Controller appliance with which the vCenter Server Appliance is registered.
2. Run this command to enable the Bash shell:

shell.set --enabled true 

3. Run the shell command to start the Bash shell and log in.
4. Run the cmsso-util unregister command to unregister the vCenter Server Appliance:

   cmsso-util unregister --node-pnid vCenterServer_System_Name --username administrator@your_domain_name --passwd vCenter_Single_Sign_On_password

   Note: In the previous example,  vCenter_Server_Appliance_System_Name is the FQDN or IP address of the vCenter Server Appliance that you want to decommission. You must run this command only on the Platform Services Controller appliance with which your vCenter Server Appliance is registered.

5. Delete the vCenter Server Appliance that you no longer need from the vSphere inventory if it is still present.

Additional Information

Using the cmsso command to unregister vCenter Server from Single Sign-On