Search the VMware Knowledge Base (KB)
View by Article ID

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

  • 40 Ratings
Language Editions

Details

After you deploy a vCenter Server with an embedded Platform Services Controller or a vCenter Server with an external Platform Services Controller, if you no longer need any of the appliances or if an appliance stops responding, you can decommission and delete the appliance from vSphere inventory and domain.

Note
: The process for removing a vCenter Server or a Platform Services Controller from the vSphere domain is irreversible. After you remove an appliance from the domain, you cannot rejoin it to the same domain. You must perform a re-install or a re-deploy of  vCenter Server or Platform Services Controller system in order to re-join it to the domain.

Solution

To decommission a Platform Services Controller

  1. Stop the Platform Services Controller that you no longer need.
  2. Manually repoint all vCenter Servers and all vCenter Server instances registered with the Platform Services Controller to another Platform Services Controller within the domain.

    For more information about repointing vCenter Server Appliances and all vCenter Server instances to another Platform Services Controller, see the vSphere Installation and Setup Guide.

Platform Services Controller Appliance:
  1. Log in as root to the appliance shell of one of the Platform Services Controller appliances within the domain.
  2. To enable the Bash shell, run the shell.set --enabled truecommand.
  3. Run the shell command to start the Bash shell and log in.
  4. Run the cmsso-util unregister command to unregister the stopped Platform Services Controller:


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

    Where, Platform_Services_Controller_System_Name is the FQDN or IP address of the Platform Services Controller that you want to decommission and host_Id is the result obtained from step 4. You must run this command only on one of the Platform Services Controller replication partners, as the synchronization removes the entries from all other Platform Services Controller replication partners.

  5. Delete the Platform Services Controller appliance that you no longer need from the vSphere inventory.
Windows Platform Services Controller:
  1. In the Platform Service Controller, click Start > Run, type cmd, and click OK. The Command Prompt window opens.
  2. Navigate to C:\Program Files\VMware\vCenter Server\bin\.

  3. Run the cmsso-util unregister command to unregister the stopped Platform Services Controller:

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

    Where, Platform_Services_Controller_System_Name is the FQDN or IP address of the Platform Services Controller that you want to decommission. You must run this command only on one of the Platform Services Controller replication partners, as the synchronization removes the entries from all other Platform Services Controller replication partners.

  4. Delete the Platform Services Controller appliance that you no longer need from the vSphere inventory.

To decommission a vCenter Server

vCenter Server Appliance:
  1. Log in as root to the appliance shell of the Platform Services Controller appliance with which the vCenter Server Appliance is registered.
  2. To enable the Bash shell, run the shell.set --enabled true command.
  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

    Where, 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. Power off the vCenter Server Appliance.
  6. Delete the vCenter Server Appliance that you no longer need from the vSphere inventory.
Windows vCenter Server:

  1. On the Platform Service Controller, click Start > Run, type cmd, and click OK. The Command Prompt window opens.
  2. Navigate to C:\Program Files\VMware\vCenter Server\bin\.
  3. Run the cmsso-util unregister command to unregister the vCenter Server:


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

    Where, vCenter_Server_System_Name is the FQDN or IP address of vCenter Server that you want to decommission. You must run this command only on the Platform Services Controller which your vCenter Server is registered.

  4. Power off the vCenter Server.

Additional Information

For translated versions of this article, see:

Tags

cmsso,unregister vcenter from sso,remove vcenter from psc,uninstall vcenter server 6

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 40 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)




Please enter the Captcha code before clicking Submit.
  • 40 Ratings
Actions
KB: