OpenStack Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora

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

http://www.apache.org/licenses/LICENSE-2.0

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.

2013-06-14

Abstract

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 shows you how to install OpenStack by using packages available through Fedora 17 as well as on RHEL and derivatives through the EPEL repository. It offers explanations for the configuration choices and provides sample configuration files.


Contents

Installing OpenStack Walk-through
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
OpenStack Terminology
Version Names and Release Notes
Code Names
OpenStack Services and Linux Services
Storage: objects, blocks, and files
Underlying Technologies
Installation Assumptions
Co-locating services
Installing OpenStack Identity Service
Basic Concepts
Installing and Configuring the Identity Service
Troubleshooting the Identity Service (Keystone)
Verifying the Identity Service Installation
Installing OpenStack Image Service
Installing and Configuring the Image Service
Troubleshooting the Image Service (Glance)
Verifying the Image Service Installation
Installing OpenStack Compute Service
Configuring the Hypervisor
KVM
QEMU
Xen, XenAPI, XenServer and XCP
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
Registering Virtual Machine Images
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
Installing OpenStack Object Storage
System Requirements
Object Storage Network Planning
Example Object Storage Installation Architecture
Installing OpenStack Object Storage on Ubuntu
Installing and Configuring the Storage Nodes
Installing and Configuring the Proxy Node
Start the Storage Nodes Services
OpenStack Object Storage Post Installation
Installing the OpenStack Dashboard
Dashboard Installation Task Flow
System requirements
Install the OpenStack Dashboard
Configure the Dashboard
Validate the Dashboard Installation
Custom Brand the Dashboard
Set up Dashboard Session Storage
VNC proxy overview
Configuration File Examples
keystone.conf
glance-registry.conf
glance-registry-paste.ini
glance-api.conf
glance-api-paste.ini
glance-scrubber.conf
nova.conf
api-paste.ini
Credentials (openrc)
cinder.conf
Dashboard configuration
etc/swift/swift.conf
etc/network/interfaces.conf
etc/swift/proxy-server.conf
etc/swift/account-server.conf
etc/swift/account-server/1.conf
etc/swift/container-server.conf
etc/swift/container-server/1.conf
etc/swift/object-server.conf
etc/swift/object-server/1.conf

loading table of contents...