Setup for Linux-KVM

This article walks you through steps to get your Platform9 Managed OpenStack (PMO) cloud up and running for Linux/KVM environments.


Before you follow this guide, make sure that all the Prerequisites for Linux/KVM are satisfied.

Step-By-Step Instructions

Once the pre-requisites are setup and you have access to your PMO account, log in to your PMO portal with the default username and password. The dashboard provides step-by-step instructions to getting started with PMO.

Step 1: Configure Neutron Networking Settings

Before you can start adding hypervisors to PMO, you must first configure Neutron networking options. Follow this guide to configure your Neutron Networking Settings

Step 2: Add Hosts To PMO

Once networking is configured, you can now start adding one or more physical servers to PMO. Navigate to “Infrastructure” and click on “Add Host” button. The “Add Host” page will walk you through three simple steps to download the PMO agent and deploy in on your Linux server.

  • Download the host agent installer specific to the Linux operating system you are using (Enterprise Linux or Ubuntu).
  • Copy the host agent installer to your physical server, or make it available via a shared folder.
  • Install the host agent on your Linux server by running the following command.

     sudo bash <path to host agent installer>


Step 3: Authorize Hosts

Once you install the agent software on your Linux server, the agent makes an outbound call to the cloud-based PMO controller specific to your account. At this point, an alert will appear in the PMO dashboard notifying you that a new server is awaiting your authorization. OpenStack tutorial - hosts added

Step 4: Configure Image Library

Each Linux server added to PMO can be authorized to run different roles. For example, if you want to run virtual machine on a host, that host should be assigned the Hypervisor role. Note that you must designate at least one server with the Image Library role. Doing this enables PMO to utilize the storage associated with that server to create an OpenStack Glance-based image catalog. Openstack tutorial-authorize-host

Step 5: Create Tenants and Invite Users

As a final step, you are now ready to start creating tenants and inviting your team members and others in your organization to start using your PMO private cloud.

  • Tenant: A tenant is a unit of multi-tenancy. You always log into PMO in the context of some tenant. The default tenant that PMO creates for you when you get started is called the “service” tenant. Any virtual machines that PMO discovers from your environment are in this tenant. You can create new tenants to map to different teams within your organization, assign them a CPU, memory and storage quota and then invite users to join the tenant.
  • Self-service portal: Each user that you invite to join PMO private cloud gets self-service portal access to the cloud.

At this point your PMO private cloud is ready to go.

If you encounter any issues, consult the Troubleshooting Guide or contact us at