Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -
OpenStack Installation Guide for
Red Hat Enterprise Linux, CentOS,
and Fedora
September 8, 2014 icehouse
ii
OpenStack Installation Guide for Red Hat Enterprise Linux, CentOS, and
Fedora
icehouse (2014-09-08)
Copyright © 2012, 2013 OpenStack Foundation All rights reserved.
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, Object Storage, Telemetry, Orchestration, and Database. You can install any of
these projects separately and configure them stand-alone or as connected entities. This guide shows you
how to install OpenStack by using packages available through Fedora 20 as well as on Red Hat Enterprise
Linux and its derivatives through the EPEL repository. Explanations of configuration options and sample
configuration files are included.
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.
Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -
OpenStack Installation Guide for
Red Hat Enterprise Linux, CentOS,
and Fedora
September 8, 2014 icehouse
iii
Table of Contents
Preface ............................................................................................................................ 7
Conventions ............................................................................................................ 7
Document change history ....................................................................................... 7
1. Architecture ................................................................................................................ 1
Overview ................................................................................................................. 1
Conceptual architecture .......................................................................................... 2
Example architectures ............................................................................................. 3
2. Basic environment configuration ................................................................................. 6
Before you begin .................................................................................................... 6
Networking ............................................................................................................. 7
Network Time Protocol (NTP) ................................................................................ 17
Security ................................................................................................................. 17
Database ............................................................................................................... 18
OpenStack packages ............................................................................................. 19
Messaging server ................................................................................................... 20
3. Configure the Identity Service ................................................................................... 22
Identity Service concepts ....................................................................................... 22
Install the Identity Service ..................................................................................... 24
Define users, tenants, and roles ............................................................................. 25
Define services and API endpoints ......................................................................... 26
Verify the Identity Service installation .................................................................... 27
4. Install and configure the OpenStack clients ................................................................ 30
Overview ............................................................................................................... 30
Install the OpenStack command-line clients ........................................................... 31
Set environment variables using the OpenStack RC file .......................................... 33
Create openrc.sh files ............................................................................................ 34
5. Configure the Image Service ...................................................................................... 35
Image Service overview ......................................................................................... 35
Install the Image Service ........................................................................................ 36
Verify the Image Service installation ...................................................................... 38
6. Configure Compute services ...................................................................................... 41
Compute service .................................................................................................... 41
Install Compute controller services ......................................................................... 43
Configure a compute node ................................................................................... 46
7. Add a networking service .......................................................................................... 48
OpenStack Networking (neutron) .......................................................................... 48
Legacy networking (nova-network) ....................................................................... 67
Next steps ............................................................................................................. 69
8. Add the dashboard ................................................................................................... 70
System requirements ............................................................................................. 70
Install the dashboard ............................................................................................ 71
Next steps ............................................................................................................. 72
9. Add the Block Storage service ................................................................................... 73
Block Storage ........................................................................................................ 73
Configure a Block Storage service controller .......................................................... 73
Configure a Block Storage service node ................................................................. 75
Verify the Block Storage installation ...................................................................... 77
Next steps ............................................................................................................. 78
Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -
OpenStack Installation Guide for
Red Hat Enterprise Linux, CentOS,
and Fedora
September 8, 2014 icehouse
iv
10. Add Object Storage ................................................................................................. 79
Object Storage service ........................................................................................... 79
System requirements for Object Storage ................................................................ 80
Plan networking for Object Storage ...................................................................... 80
Example of Object Storage installation architecture ............................................... 82
Install Object Storage ............................................................................................ 83
Install and configure storage nodes ....................................................................... 85
Install and configure the proxy node ..................................................................... 86
Start services on the storage nodes ....................................................................... 89
Verify the installation ............................................................................................ 89
Add another proxy server ..................................................................................... 90
Next steps ............................................................................................................. 90
11. Add the Orchestration service ................................................................................. 91
Orchestration service overview .............................................................................. 91
Install the Orchestration service ............................................................................. 91
Verify the Orchestration service installation ........................................................... 93
Next steps ............................................................................................................. 95
12. Add the Telemetry module ...................................................................................... 96
Telemetry .............................................................................................................. 96
Install the Telemetry module ................................................................................. 97
Install the Compute agent for Telemetry ............................................................... 99
Configure the Image Service for Telemetry .......................................................... 100
Add the Block Storage service agent for Telemetry .............................................. 101
Configure the Object Storage service for Telemetry ............................................. 101
Verify the Telemetry installation .......................................................................... 102
Next steps ........................................................................................................... 103
13. Add the Database service ...................................................................................... 104
Database service overview ................................................................................... 104
Install the Database service ................................................................................. 105
Verify the Database service installation ................................................................ 108
14. Launch an instance ................................................................................................ 109
Launch an instance with OpenStack Networking (neutron) .................................. 109
Launch an instance with legacy networking (nova-network) ................................. 115
A. Reserved user IDs .................................................................................................... 121
B. Community support ................................................................................................. 122
Documentation ................................................................................................... 122
ask.openstack.org ................................................................................................ 123
OpenStack mailing lists ........................................................................................ 123
The OpenStack wiki ............................................................................................. 124
The Launchpad Bugs area ................................................................................... 124
The OpenStack IRC channel ................................................................................. 125
Documentation feedback .................................................................................... 125
OpenStack distribution packages ......................................................................... 125
Glossary ....................................................................................................................... 126
Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -Icehouse -
OpenStack Installation Guide for
Red Hat Enterprise Linux, CentOS,
and Fedora
September 8, 2014 icehouse
v
List of Figures
1.1. Conceptual architecture ............................................................................................ 2
1.2. Three-node architecture with OpenStack Networking (neutron) ................................ 4
1.3. Two-node architecture with legacy networking (nova-network) ................................ 5
2.1. Three-node architecture with OpenStack Networking (neutron) ................................ 8
2.2. Two-node architecture with legacy networking (nova-network) ............................... 14
7.1. Initial networks ...................................................................................................... 62
