OpenStack Tutorial: How to Deauthorize a Host from Platform9

This tutorial describes the process of deauthorizing or removing a host from Platform9.

Step 1 - Remove All Images from the Host

If the host has been assigned the image library role, first check to see if there are images in your image catalog using the OpenStack Glance client.

Follow Getting Started with the OpenStack Command Line if the Glance client is not installed.

Also, export the environment variables from the "API Access" tab of the "Access and Security" view.

glance image-list

If there are, then back up each image into a temporary location (optional).

glance image-download --file 

Then, delete each image.

glance image-delete <id or name>

Step 2 - Remove All Volumes Associated with the Host

If the host has the block storage role, first ensure that all volumes associated with that host are in the available state.

If the volumes are in the in-use state, detach them by editing the volume settings from the Actions column of the Volumes and Snapshot view.

In this case, we are deauthorizing centos-host1, so only volumes from this host need to be detached.


Screen Shot 2015-10-05 at 7.31.03 PM

Confirm the detach operations.


Screen Shot 2015-10-05 at 7.55.00 PM

Then, delete the volumes associated with the host by clicking in the Actions column of the Volumes and Snapshot view.


Screen Shot 2015-10-05 at 7.47.21 PM

Confirm the deletion of the volumes.

Screen Shot 2015-10-05 at 7.50.32 PM

Step 3 - Deauthorize the Host

At this point, you are ready to deauthorize the host from Platform9. To do this, click on the 'remove' button in the 'Actions' column for that Host in the 'Infrastructure' menu.


Screen Shot 2015-10-05 at 6.07.32 PM

Confirm the deauthorization.


Screen Shot 2015-10-05 at 6.09.47 PM

The host will reappear in the deauthorized state.


Screen Shot 2015-10-05 at 6.13.47 PM

Step 4 (Optional) - Remove Platform9 Host Agent and Other Software from the Host

If you wanted to completely remove the host from Platform9, then you need to follow this last step to fully uninstall all Platform9 software from the Host.

Get the name of the Platform9 host agent running on your server:

For RedHat-based distributions:

sudo rpm -qa | grep pf9-hostagent

For Ubuntu:

sudo dpkg -l | grep pf9-hostagent

Uninstall the agent and its dependencies.

For RedHat-based distributions:

 sudo yum -y erase <pf9-agent-name-you-previously-grepped>

For Ubuntu:

 sudo apt-get purge <pf9-agent-name-you-previously-grepped>

This will uninstall the agent, along with any dependencies it installed on the server, such as OpenStack nova drivers, image library components, etc.

Finally, terminate the pf9-sidekick.js process if present. This process is used as an emergency rescue mechanism for failed upgrades wherein the host agent might stop functioning. By design, the process is not terminated when the host agent software is removed. Use the ps -C command to find the process' ID, and if it exists, use kill to terminate it. This example works on both RedHat and Ubuntu based distributions:

> sudo ps -C pf9-sidekick.js
PID TTY TIME CMD
1344 ? 00:02:16 pf9-sidekick.js
> sudo kill 1344

That's it! Your Linux/KVM server is now completely removed from Platform9.


November 16, 2015