Host agent package extraction and install

Extract packages from the Platform9 Installer

This article describes how to extract RPM and Debian packages from the Platform9 host agent / installer.

Step 1 - Run the Platform9 Installer with the ‘–extract’ Option

On the terminal, run the installer for the platform of your choice with the --extract option. In the case of CentOS/Redhat/Scientific Linux:

sudo bash platform9-install-redhat.sh --extract

Step 2 - Switch to the Extraction Directory and Copy Packages from the Extracted Archive

On the terminal, locate a temporary directory with path /tmp/pf9-install-XXXXX where XXXXX is a randomly generated set of characters, and then copy the RPM or Deb packages from there to your chosen location.


There is an important sequence of steps you need to follow to ensure the Platform9 host agent is installed and started correctly. Please refer to Installing RPM and Debian Packages Manually or Through a Configuration Management Tool for specific instructions on how to activate the Platform9 host agent.

Manual install of Platform9 host agent packages

This article describes how to install and start the Platform9 OpenStack host agent using the RPM or Debian packages extracted from the installer. Instructions on extracting the packages from the installer can be found here.

Step 1 - (Optional) Add the Packages to Your Yum or Apt Repository

Add the packages to your repository and make sure that the repository is accessible to the machine that needs to the install the packages. Consult your operating system’s documentation to find instructions on creating and using repositories.

Step 2 - Install the Packages

Install the packages using your operating system’s package manager or a configuration management tool such as Chef/Puppet/Ansible. In the case of CentOS/Redhat/Scientific Linux:

yum install -y pf9-hostagent
yum install -y pf9-comms

If both packages are registered in a yum repository, installing pf9-comms will automatically install pf9-hostagent. If installing from local package files instead of a repository, you will need to specify the full file names of the packages, including version and extension.

Step 3 - Start the services

service pf9-comms start
service pf9-hostagent start