One of the more interesting announcements to come out of the Atlanta OpenStack Design Summit was Red Hat's statement that they were going to open source ManageIQ, a cloud management platform. You can read the press announcement here.

In prior tutorials, we showed you how to install ManageIQ on Ubuntu on the CenturyLink Cloud and how to get a stand-alone OpenStack cloud running on the CenturyLink Cloud. We are now going to demonstrate how to configure ManageIQ to connect to, and manage, your OpenStack cloud.

Install ManageIQ and OpenStack

First we need to get both ManageIQ and OpenStack up and running. Follow the instructions for installing ManageIQ (here) and OpenStack (here).

Note: Since we will be running ManageIQ and OpenStack in a single data center and under a single account the programs should share a VLAN by default. You can check your CenturyLink Cloud instances by looking at the private IP and ensure that the first 3 decimal numbers in the IP address are the same:


Configure ManageIQ for OpenStack

Log into the ManageIQ console (user: admin, password: smartvm). Navigate to Clouds -> Providers. From the Configuration drop down choose "Add a New Cloud Provider". This is the configuration page that will generate the connection to the OpenStack cloud.

new cloud

Under Basic Information select "OpenStack" as the Type. This allows the OpenStack specific configuration items to be selected. Give the connection a name, enter the host name from your OpenStack instance, and then enter the local IP of the OpenStack instance. Leave the API Port and Zone as is.

We will be using the "admin" user in the "admin" tenant on the OpenStack cloud to connect to and have sufficient privileges to manage or monitor the cloud. You should verify/set the default admin user password to "admin" on the OpenStack cloud. Go to Admin -> Identity -> Users.

admin pw

Select to Edit the Admin user and set the password.

admin pw

Finally, set the ManageIQ credentials for both Default and AMQP to User ID: admin and Password: admin. When you hit the Validate button ManageIQ will connect to OpenStack and verify that the credentials are accepted. Once you have verified the credentials you should be able to get the details on the new Cloud Provider:

openstack summary

The last configuration item we need to set is to allow the ManageIQ system to serve as the "Automation Engine" role. This is off by default and if you find that your provisioning jobs look good, but are stuck in the "Pending" state... You have forgotten to turn on the automation role. Select Configure -> Configuration and under Server Control make sure the Automation Engine box is checked.

Create new OpenStack instances through ManageIQ

Now that we have OpenStack set up as a provider to ManageIQ let's demonstrate that we can instantiate instances on the cloud platform through the management system.

Using the ManageIQ console select Clouds and Instances and then from the left hand navigation window highlight your new OpenStack cloud. You will notice that there are "No Records Found" which is correct, since we have not yet started any VM's. From the Lifecycle drop down select Provision Instances. This will bring up a selection dialog that is populated with the image types from your OpenStack cloud. For this exercise select the _Fedora-x8664-20-20140618-sda image and hit the Continue button.

The next set of dialogs specifies the character of the instance you want to create. ManageIQ implements an approval workflow, so the first screen will be the details of the requestor. For expediency, we are going to set our request to be "auto-approved" and so the Request Information details won't be applicable (but you have to enter information in all of the starred entry boxes).

Select the Purpose tab and select the Auto Approve drop down. Check the "1" box, this will allow a request for 1 instance to be auto-approved.

Select the Catalog tab, you will note that the Fedora image is highlighted. Finally, give the instance a base name in the Instance Name field. For demonstration purposes I am setting this to "Tutorial".

From the Environment tab select the "Choose Automatically" option for the instance placement. Next, from the Properties tab select the "m1.small" for the Instance Type. Since we will accept all of the rest of the defaults now hit the Submit button. You should see the "Requests" page with your request at the top of the list, in a "Pending" state". Wait a bit and hit the Reload button. You will see the Request go from "Pending" to "Active" and the "Reason" to "Auto-Approved".

To ensure that everything is working correctly, go to the OpenStack console and navigate to Admin -> Instances. You should see something like this:


And if you go to the ManageIQ console and navigate to Clouds -> Instances -> OpenStack Provider (your name will be here) -> nova -> Tutorial (your name will be here) you will see something like this:

manageiq instance


Congratulations! You are now running the community version of ManageIQ, connected to an OpenStack private cloud, all being hosted on the CenturyLink Cloud. From here you can explore the many features and options available through the ManageIQ interface. Besides the console UI's both ManageIQ and OpenStack have comprehensive API's to perform their tasks.

Other tutorials will explore these programmatic interfaces in more detail.