Havana -  Havana -  Havana -  Havana -  Havana -  Havana -  Havana -  Havana - 

OpenStack Installation Guide for Ubuntu 12.04 (LTS)


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 consists of several key projects that you install separately but that work together depending on your cloud needs. These projects include Compute, Identity Service, Networking, Image Service, Block Storage Service, Object Storage, Telemetry, and Orchestration. You can install any of these projects separately and configure them standalone or as connected entities. This guide walks through an installation by using packages available through Ubuntu 12.04 (LTS). Explanations of configuration options and sample configuration files are included.


Document change history
1. Architecture
Conceptual architecture
Logical architecture
Example architectures
2. Basic operating system configuration
Before you begin
Network Time Protocol (NTP)
MySQL database
OpenStack packages
Messaging server
3. Configure the Identity Service
Identity Service concepts
Install the Identity Service
Define users, tenants, and roles
Define services and API endpoints
Verify the Identity Service installation
4. Configure the Image Service
Image Service overview
Install the Image Service
Verify the Image Service installation
5. Configure Compute services
Compute service
Install Compute controller services
Configure a Compute node
Enable Networking
Launch an instance
6. Add the dashboard
System requirements
Install the dashboard
Set up session storage for the dashboard
7. Add the Block Storage Service
Block Storage Service
Configure a Block Storage Service controller
Configure a Block Storage Service node
8. Add Object Storage
Object Storage service
System requirements
Plan networking for Object Storage
Example Object Storage installation architecture
Install Object Storage
Install and configure storage nodes
Install and configure the proxy node
Start services on the storage nodes
Object Storage post-installation tasks
9. Install the Networking service
Networking considerations
Neutron concepts
Install Networking services
Neutron deployment use cases
10. Add the Orchestration service
Orchestration service overview
Install the Orchestration service
Verify the Orchestration service installation
11. Add the Telemetry module
Install the Telemetry module
Install the Compute agent for Telemetry
Add the Image Service agent for Telemetry
Add the Block Storage Service agent for Telemetry
Add the Object Storage agent for the Telemetry service
Verify the Telemetry installation
A. Community support
OpenStack mailing lists
The OpenStack wiki
The Launchpad Bugs area
The OpenStack IRC channel
Documentation feedback
OpenStack distribution packages

List of Examples

2.1. /etc/network/interfaces
Log a bug against this page

loading table of contents...