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
1344 ? 00:02:16 pf9-sidekick.js
> sudo kill 1344

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

Note: Any workloads running on this server remain completely untouched.

Vamsi Chemitiganti
Chief Strategist at Platform9 Systems. Vamsi works with Platform9's Client CXOs and Architects to help them on key business transformation initiatives. In previous roles, Vamsi was the CTO for RiskCounts - a FinTech based in NYC. Prior to that spent eight years as the Chief Architect for Red Hat’s Global Financial Services Vertical based out of NYC. Vamsi also spent two years as the General Manager (Financial Services) at Hortonworks. In both roles, Vamsi was responsible for driving Red Hat and Hortonworks technology vision from a client business standpoint. The clients Vamsi engages with on a daily basis span marquee financial services names across major banking centers in Wall Street, Toronto, London & in Asia. These include businesses in capital markets, retail banking, wealth management and IT operations. holds a BS in Computer Science and Engineering as well as an MBA from the University of Maryland, College Park. He is also a regular speaker at industry events on topics ranging from Cloud Computing, Big Data, AI, High-Performance Computing and Enterprise Middleware. In 2013, Wall Street and Technology Magazine identified Vamsi as a Global Thought Leader. Vamsi writes weekly on financial services business and technology landscape at his highly influential blog –

The browser you are using is outdated. For the best experience please download or update your browser to one of the following: