OpenStack Installation Guide for Ubuntu 12.04 (LTS)

Grizzly, 2013.1 with Object Storage 1.8.0

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.



The OpenStack™ system has several key projects that are separate installations but can work together depending on your cloud needs: OpenStack Compute, OpenStack Object Storage, OpenStack Identity Service, and OpenStack Image Service. You can install any of these projects separately and then configure them either as standalone or connected entities. This guide walks through an installation using packages available through Ubuntu 12.04 (LTS). It offers explanations for the configuration choices as well as sample configuration files.


1. Installing OpenStack Walk-through
Installing on Ubuntu
ISO Installation
Manual Installation on Ubuntu
Scripted Development Installation
Example Installation Architectures
Service Architecture
Compute and Image System Requirements
Compute Network Planning
Installing Network Time Protocol (NTP)
Installing MySQL
Installing A Messaging Server
2. OpenStack Terminology
Version Names and Release Notes
Code Names
OpenStack Services and Linux Services
Storage: objects, blocks, and files
Object storage
Block storage (SAN)
File storage (NAS)
3. Underlying Technologies
4. Installation Assumptions
Co-locating services
5. Installing OpenStack Identity Service
Identity Service Concepts
User management
Service management
Installing and Configuring the Identity Service
Configuring Services to work with Keystone
Defining Services
Troubleshooting the Identity Service (Keystone)
Verifying the Identity Service Installation
6. Installing OpenStack Image Service
Installing and Configuring the Image Service
Configuring the Image Service database backend
Edit the Glance configuration files
Troubleshooting the Image Service (Glance)
Verifying the Image Service Installation
7. Installing OpenStack Compute Service
Configuring the Hypervisor
Checking for hardware virtualization support
Enabling KVM
Specifying the CPU model of KVM guests
KVM Performance Tweaks
Xen, XenAPI, XenServer and XCP
Xen terminology
XenAPI deployment architecture
XenAPI pools
Installing XenServer and XCP
Xen Boot from ISO
Further reading
Xen Configuration Reference
Pre-configuring the network
Configuring the SQL Database (MySQL) on the Cloud Controller
Configuring the SQL Database (PostgreSQL) on the Cloud Controller
Installing and configuring Block Storage (Cinder)
Installing Compute Services
File format for nova.conf
Configuring OpenStack Compute
Configuring the Database for Compute
Creating the Network for Compute VMs
Verifying the Compute Installation
Defining Compute and Image Service Credentials
Installing Additional Compute Nodes
Adding Block Storage Nodes
8. Registering Virtual Machine Images
9. Running Virtual Machine Instances
Security groups: Enabling SSH and ICMP (ping)
Adding a keypair
Confirm all services running
Starting an instance
Bringing down an instance
10. Installing OpenStack Object Storage
System Requirements
Object Storage Network Planning
Example Object Storage Installation Architecture
Installing OpenStack Object Storage on Ubuntu
Before You Begin
General Installation Steps
Installing and Configuring the Storage Nodes
Installing and Configuring the Proxy Node
Start the Storage Nodes Services
OpenStack Object Storage Post Installation
Verify the Installation
Adding an Additional Proxy Server
11. Installing the OpenStack Dashboard
About the Dashboard
System Requirements for the Dashboard
Install and configure the dashboard
Configuring the Dashboard
Validating the Dashboard Install
How To Custom Brand The OpenStack Dashboard (Horizon)
OpenStack Dashboard Session Storage
Local Memory Cache
Cached Database
Overview of VNC Proxy
About nova-consoleauth
Typical Deployment
Frequently asked questions about VNC access to VMs
A. Appendix: Configuration File Examples
Credentials (openrc)
Dashboard configuration
Log a bug against this page

loading table of contents...