We have deployed Openstack Essex to our HPC Cluster, Gibson. This guide will describe the deployment process using a tool called 'dodai-deploy'.
Our configuration is as follows:
However, we assume the hostname used on any other system will not be the same. Therefore, in places where we use these hostnames, please substitute the appropriate names as used in your configuration.
Ubuntu 12.04 Server LTS is used as the base system for this install. Other distributions or versions of Ubuntu may also be used but the installation procedure may vary depending on the distribution used.
Before installation of Openstack Essex the hosts file (/etc/hosts) for each node must be modified as follows:
127.0.0.1 localhost 127.0.1.1 gibsonX
(Note: X is a number corresponding to the node. In this example X ranges from 1 to 5)
127.0.0.1 localhost 192.168.99.1 gibson1 192.168.99.2 gibson2 192.168.99.3 gibson3 192.168.99.4 gibson4 192.168.99.5 gibson5
(Note: The IP addresses assigned to gibson nodes are static IP's. Please use the IP addresses as assigned by your DHCP router.)
The head node in this deployment will be used to host the following services:
- Openstack Dashboard (Web interface)
- MySQL Server
- Nova API
- Nova Certification Manager
- Nova Network Controller
- Nova Object Storage
- Nova Scheduler
- Nova Volume Manager
This makes the head node a single point of failure, or bottleneck. However, deployment of Openstack Essex can be scaled such that these services are distributed amongst many nodes.
On the head node execute the following set of commands from an SSH terminal
sudo apt-get install git -y git clone https://github.com/nii-cloud/dodai-deploy.git cd dodai-deploy sudo setup-env/setup.sh server sudo setup-env/setup.sh -s gibson1 node
The services must be started by executing the following command from an SSH terminal:
cd dodai-deploy/script sudo ./start-servers
Setup Of Additional Nodes
For each node in addition to the head node, execute the following commands in an SSH terminal:
sudo apt-get install git -y git clone https://github.com/nii-cloud/dodai-deploy.git cd dodai-deploy setup-env/setup.sh -s gibson1 node
Once the head node services have started, point your web browser to the following page:
Step One: Add Nodes To Dodai-Deploy Config
Click on the "New node" link to begin adding nodes to the configuration. A dropdown menu listing all available nodes will be displayed, as well as a button which adds the selected node to the Dodai-Deploy configuration. After adding the nodes you will be presented with a list of nodes with their corresponding IP addresses.
Step Two: Install Keystone
Click on the "Proposals" link on the right side of the page to start a new installation proposal. Click on "New proposal" and modify the information to reflect the following:
Click on the "Create Proposal" button at the bottom of the page to create the proposal. This will return you to the proposal list, which now contains a proposal for Keystone. Click on the "Install" link next to the keystone proposal to initiate the installation. Once the installation has completed, click on the "Test" link to ensure that the install was successful.
Step Three: Install Glance
Glance is the Openstack image server software. We will be installing Glance onto the gibson2 node. The installation is very similar to the installation of Keystone. First, click on the proposals link on the left side of the screen. Click on "Add New Proposal" to begin a new proposal for Glance. Now, modify the configuration as follows:
Step Four: Install Nova
SSH into the head node (gibson1) and execute the following commands:
cd dodai-deploy/setup-env sudo ./create-volume-group.sh loopback nova-volumes /root/volume.data 4
Now, you must reboot the head node. After the machine has booted completely, restart the services as shown previously. Direct your web browser to the dodai-deploy portal again, as shown previously, and create a new proposal for Nova.
The following settings must be modified for Nova:
Step Seven: Ensure Installation Complete and Test
Done!Now, you should have a working Openstack Essex IaaS cloud. Point your web browser to the head node:
http://gibson1/to begin using Openstack Essex. The default username is: admin, and the default password is: admin. However, these settings can be changed at a later date.