Red Hat Enterprise Linux OpenStack Platform

Getting Started Guide

Getting Started with Red Hat OpenStack 2.1 (Folsom)

Edition 1.0

Red Hat Documentation Team

Legal Notice

Copyright © 2012, 2013 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
OpenStack Network configuration based on chapters 1, 2, and 3 of OpenStack Network Administration Guide (for Folsom 2012.2) available at http://docs.openstack.org/trunk/openstack-network/admin/content/index.html
Copyright 2011, 2012, 2013 OpenStack Foundation
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.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
The OpenStack Word Mark and OpenStack Logo are either registered trademarks / service marks or trademarks / service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
All other trademarks are the property of their respective owners.


1801 Varsity Drive
RaleighNC 27606-2072 USA
Phone: +1 919 754 3700
Phone: 888 733 4281
Fax: +1 919 754 3701

Abstract

This manual covers the basic getting started tasks for OpenStack Folsom Preview.
Preface
1. Document Conventions
1.1. Typographic Conventions
1.2. Pull-quote Conventions
1.3. Notes and Warnings
I. Introduction
1. Architecture
2. Prerequisites
2.1. System Requirements
2.1.1. Single Node ("All in One") Deployments
2.1.2. Cloud Controller Deployment with One or More Compute Nodes
2.2. Configuring Software Repositories
2.3. Configuring sudo Access
2.4. Installing OpenStack Utilities
II. Upgrading an OpenStack Deployment
3. Upgrading from Red Hat OpenStack 1.0 (Essex) Preview to Red Hat OpenStack 2.0 (Folsom) Preview
4. Upgrading from Red Hat OpenStack 2.0 (Folsom) Preview to Red Hat OpenStack 2.1 (Folsom)
III. Deploying OpenStack using PackStack
5. Installing PackStack
6. Running PackStack
6.1. Quick Start Deployment using PackStack
6.2. Running PackStack Interactively
6.3. Running PackStack Non-interactively
6.3.1. Generating a PackStack Answer File
6.3.2. Editing a PackStack Answer File
6.3.3. Running PackStack with an Answer File
IV. Deploying OpenStack Manually
7. Deploying Identity Services (Keystone)
7.1. Installation and Initial Configuration
7.2. Creating Users
8. Deploying Object Storage Services (Swift)
8.1. Creating the Swift Ring Files
8.2. Configuring Keystone
8.3. Configuring the Swift Proxy
8.4. Configuring Swift Storage Nodes
8.5. Testing Swift
9. Deploying Image Services (Glance)
9.1. Building Images using Oz
9.2. Adding Images to Glance
10. Deploying Volume Services (Cinder)
11. Deploying Compute Services (Nova)
12. Deploying OpenStack Networking Services
12.1. Introduction to OpenStack Networking
12.1.1. OpenStack Networking Architecture
12.1.2. OpenStack Networking API
12.1.3. OpenStack Networking Plug-ins
12.2. Configuring Keystone for OpenStack Networking
12.3. Configuring the Cloud Controller or Network Node for OpenStack Networking
12.3.1. Installing the OpenStack Networking Service
12.3.2. Installing the Message Broker
12.3.3. Configuring the OpenStack Networking Service
12.4. Configuring Compute Nodes for OpenStack Networking
12.4.1. Configuring Nova to reach the OpenStack Network API
12.4.2. Configuring Vif-plugging in Nova
12.4.3. Example nova.conf (for nova-compute and nova-api)
12.5. Installing OpenStack Networking Agents
12.5.1. Installing the Open vSwitch Agent
12.5.2. Installing the OpenStack Networking DHCP Agent (quantum-dhcp-agent)
12.5.3. Installing the OpenStack Networking L3 Agent (quantum-l3-agent)
12.6. Installing the Client (quantum)
13. Deploying the Dashboard (Horizon)
13.1. Installing Horizon
13.2. Enabling Console Access
V. Using OpenStack
14. Launching an Instance
14.1. Launching an Instance using the Dashboard
14.2. Launching an Instance using the Command Line Interface
15. Creating a Volume
15.1. Creating a Volume using the Dashboard
15.2. Creating a Volume using the Command Line Interface
16. Attaching a Volume
16.1. Attaching a Volume using the Dashboard
16.2. Attaching a Volume using the Command Line Interface
16.3. Accessing a Volume from a Running Instance
17. Creating a Snapshot
17.1. Creating a Snapshot using the Dashboard
17.2. Creating a Snapshot using the Command Line Interface
18. Modifying Security Groups
18.1. Adding a Rule to a Security Group using the Dashboard
18.2. Adding a Rule to a Security Group using the Command Line Interface
19. Adding Floating IP Addresses
19.1. Adding Floating IP Addresses using the Dashboard
19.2. Adding Floating IP Addresses using the Command Line Interface
20. Controlling Instance State (Suspend, Resume, Reboot, Terminate)
21. Deleting Instances
A. Revision History