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

Procedure

  1. Select Infrastructure > Hosts.
  2. Choose an unregister option.
    Option Procedure
    Unregister
    1. 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
    1. 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"/>