Uninstall HostAgent

In certain scenarios the Platform9 Host Agent will need to be uninstalled and all CLI packages removed for a node to be successfully reused. This includes:

  • Cloning a VM that has Host Agent installed
  • Deauthorizing a node and re-running prep-node
  • Host Agent installation was interrupted causing the installation to fail
  • Node authorization fails due to network connectivity

To remove the Host Agent follow the steps below.

Step 1

To completely reuse a node the node must be first detached from a cluster by using the Scale Workers or Scale Master command on the Infrastructure ‘Clusters’ dashboard or using the CLI. Once the node has been removed from the cluster it needs to be deauthorized form the Platform9 SaaS Management Plane. This can be done on the Infrastructure ‘Nodes’ dashboard by selecting the node and clicking the ‘Deauthorize Node’ table action. Once this command has been completed the node is detached and no longer under management.

The alternate approach is to delete the cluster and deauthorize all nodes.

Step 2

Ensure the Host Agent process is not running by running the command:

Bash
Copy

If the Host Agent is running stop the Host Agent process on the Node by running:

Bash
Copy

Stopping HostAgent should stop all other services. Run the commands below to ensure all services are stopped.

Bash
Copy

Step 3

Remove the Host Agent by running

Ubuntu
CentOS
Copy

Example Host Agent Removal

Bash
Copy

Clean up logs

Remove the existing logs

Bash
Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard