Unregistering Hosts

When you unregister a host you remove it from being managed by the Administrator server and destroy any nodes that the host manages. You can unregister hosts from the GUI or by using the CLI.

GUI

Note: A Host in the 'running' state cannot be deleted from the UI. The Delete icon is disabled and the Unregister icon is enabled. On the other hand, when the Host is in any state other than the 'running' state, the Unregister icon is disabled and the Delete icon is enabled. The CLI functionality for the Delete and Unregister operations remains unchanged.

Procedure

  1. Select Infrastructure > Hosts.
  2. Choose an unregister option.
    Option Procedure
    Unregister Click Unregister or select Unregister > Unregister. If no nodes are installed on the host, the host is unregistered and deleted from the Administrator database. If nodes are installed on the host, the operation fails.
    Force Unregister Select Unregister > Force unregister. Nodes are force uninstalled from the host and the host, nodes, and application components deployed on the nodes are deleted from the Administrator database. It's usually a good idea to first use Unregister. If you decide to proceed with removing that data, use Force Unregister.

CLI

Procedure

  1. In the data file, specify a Host element in base format (the default). 
    <Host name="SecondHost" />
  2. In the build file, set the action attribute of the AMXAdminTask element to delete and the objectSelector attribute to Host. 
    <AMXAdminTask action="delete" objectSelector="Host"/>
  3. To perform a force uninstall, specify the -force option. 
    <AMXAdminTask action="delete" objectSelector="Host" force="true"/>