Automate Agent Install for Linux-KVM

A Platform9 Managed OpenStack Account comes with a host agent that must be downloaded and deployed on each of your physical servers/hosts to make them part of your Platform9 private cloud.

This tutorial describes an easy mechanism to:

• Fetch the Platform9 OpenStack host agent directly on a given Linux/KVM Host
• Automate deployment of the host agent using configuration parameters

Step 1 — Downloading the Platform9 OpenStack Host Agent

Following are the two ways to get the Platform9 OpenStack host agent on each of your physical servers.

• Download the Platform9 host agent from Platform9 portal, then copy it over to each of your physical servers.
• Download the host agent directly from each of your physical server using the Python script provided with this Tutorial.

The Python script is located on our GitHub page and can be downloaded directly from there. This script downloads the Platform9 host agent via the command line following successful authentication of your Platform9 account. The script does not depend on any third-party modules. As long as you have the standard library for Python 2 or 3 (included in the minimum installation of Python), it should work out of the box. Once downloaded, run the script using one of the following commands.

For CentOS/Red Hat:

python pf9-download.py --account_endpoint acme.platform9.net --region myRegion --user john.doe@acme.com --tenant myOrg --platform redhat

For Ubuntu 16.04:

python pf9-download.py --account_endpoint acme.platform9.net --region myRegion --user john.doe@acme.com --tenant myOrg debian

This will download the host agent in the current working directory. When running interactively, the script will prompt for the account password. You can optionally pass the password to the script at the command line using the ‘password’ option. Example:

python pf9-download.py --account_endpoint acme.platform9.net --region myRegion --user john.doe@acme.com --password supersecurestuff --tenant myOrg debian

Step 2 — Unattended Installation

2.1 Environments without HTTP proxy

If you do not have an HTTP proxy server in your environment, trigger the host agent self-install package with a --no-proxy option.

bash platform9-install-redhat.sh --no-proxy

Doing so will automate installation of the host agent without proxy.

2.2 Environments with HTTP proxy

If you have an HTTP proxy server in your environment, you can also automate this by passing in the --proxy=<server>:<port> option. Note the colon between the <server> and <port>.

bash platform9-install-redhat.sh --proxy=squid.mycompany.com:3128