Red Hat Enterprise Linux OpenStack Platform 5

Deploying OpenStack: Learning Environments (Manual Setup)

Manually installing and configuring Red Hat Enterprise Linux OpenStack Platform

OpenStack Documentation Team

Red Hat Customer Content Services


This guide explains how to install Red Hat Enterprise Linux OpenStack Platform 5 on Red Hat Enterprise Linux. In particular, this guide focuses on providing an instructional walkthrough of the OpenStack deployment process. As such, this guide provides instructions on how to install each OpenStack component manually.
Manually installing OpenStack components will result in a fully functional OpenStack deployment, but may not be suitable for most production environments.
I. Introduction
1. Product Introduction
1.1. Overview
1.2. Architecture
1.3. Deployment Tools and Methods
1.4. Supported Virtual Machine Operating Systems
2. Prerequisites
2.1. Software Requirements
2.1.1. Operating System Requirements
2.1.2. Software Repository Configuration
2.1.3. Reserved UIDs and GIDs
2.2. Hardware Requirements
2.2.1. Compute Node Requirements
2.2.2. Network Node Requirements
2.2.3. Block Storage Node Requirements
2.3. Prerequisite Database Server
2.3.1. Install the MariaDB Database Packages
2.3.2. Configure the Firewall to Allow Database Traffic
2.3.3. Start the Database Service
2.3.4. Configuring the Database Administrator Account
2.3.5. Testing Connectivity
2.4. Prerequisite Message Broker
2.4.1. Configure the Firewall for Message Broker Traffic
2.4.2. Install and Configure the RabbitMQ Message Broker
2.5. Installation Prerequisites Checklists
II. Install OpenStack Services Manually
3. OpenStack Identity Service Installation
3.1. Identity Service Overview
3.2. Identity Service Requirements
3.3. Install the Identity Packages
3.4. Create the Identity Database
3.5. Configure the Identity Service
3.5.1. Set the Identity Service Administration Token
3.5.2. Configure the Identity Service Database Connection
3.5.3. Configure the Public Key Infrastructure
3.5.4. Configure the Firewall to Allow Identity Service Traffic
3.5.5. Populate the Identity Service Database
3.6. Start the Identity Service
3.7. Create the Identity Service Endpoint
3.7.1. Service Regions
3.8. Create an Administrator Account
3.9. Create a Regular User Account
3.10. Create the Services Tenant
3.11. Validate the Identity Service Installation
3.11.1. Troubleshoot Identity Client (keystone) Connectivity Problems
4. OpenStack Object Storage Service Installation
4.1. Object Storage Service Overview
4.2. Services that Make Up the Object Storage Service
4.3. Architecture of the Object Storage Service
4.4. Object Storage Service Requirements
4.5. Install the Object Storage Service Packages
4.6. Configure the Object Storage Service
4.6.1. Create the Object Storage Service Identity Records
4.6.2. Configure the Object Storage Service Storage Nodes
4.6.3. Configure the Object Storage Service Proxy Service
4.6.4. Object Storage Service Rings
4.6.5. Build Object Storage Service Ring Files
4.7. Validate the Object Storage Service Installation
5. OpenStack Image Service Installation
5.1. Image Service Overview
5.2. Image Service Requirements
5.3. Install the Image Service Packages
5.4. Create the Image Service Database
5.5. Configuring the Image Service
5.5.1. Configuration Overview
5.5.2. Create the Image Identity Records
5.5.3. Configure the Image Service Database Connection
5.5.4. Configure Image Service Authentication
5.5.5. Using the Object Storage Service for Image Storage
5.5.6. Configure the Firewall to Allow Image Service Traffic
5.5.7. Configure the Image Service to Use SSL
5.5.8. Populate the Image Service Database
5.5.9. Enable Image Loading Through the Local File System
5.6. Launch the Image API and Registry Services
5.7. Validate the Image Service Installation
5.7.1. Obtain a Test Disk Image
5.7.2. Build a Custom Virtual Machine Image
5.7.3. Upload a Disk Image
6. OpenStack Block Storage Installation
6.1. Block Storage Service Overview
6.2. Block Storage Installation Overview
6.3. Block Storage Prerequisite Configuration
6.3.1. Create the Block Storage Database
6.3.2. Create the Block Storage Service Identity Records
6.4. Common Block Storage Configuration
6.4.1. Install the Block Storage Service Packages
6.4.2. Configure Block Storage Service Authentication
6.4.3. Configure the Block Storage Service to Use SSL
6.4.4. Configure RabbitMQ Message Broker Settings for the Block Storage Service
6.4.5. Configure the Block Storage Service Database Connection
6.4.6. Configure the Firewall to Allow Block Storage Service Traffic
6.4.7. Populate the Block Storage Database
6.4.8. Increase the Throughput of the Block Storage API Service
6.5. Volume Service Configuration
6.5.1. Block Storage Driver Support
6.5.2. Configure OpenStack Block Storage to use an LVM Storage Back End
6.5.3. Configure SCSI Target Daemon
6.6. Launch the Block Storage Services
6.7. Validate the Block Storage Service Installation
7. OpenStack Networking Service Installation
7.1. OpenStack Networking Service Overview
7.2. OpenStack Networking Installation Overview
7.2.1. OpenStack Networking Architecture
7.2.2. OpenStack Networking API
7.2.3. OpenStack Networking API Extensions
7.2.4. OpenStack Networking Plug-ins
7.2.5. VMware NSX Integration
7.2.6. Open vSwitch Overview
7.2.7. Modular Layer 2 (ML2) Overview
7.2.8. Choose a Network Back-end
7.2.9. Configure the L2 Population mechanism driver
7.2.10. OpenStack Networking Agents
7.2.11. Tenant and Provider networks
7.2.12. Multiple Networks on a Single Node
7.2.13. Recommended Networking Deployment
7.2.14. Kernel Requirements
7.3. Networking Prerequisite Configuration
7.3.1. Configure OpenStack Networking Authentication
7.4. Common Networking Configuration
7.4.1. Disable Network Manager
7.4.2. Install the Networking Service Packages
7.4.3. Configure the Firewall to Allow OpenStack Networking Traffic
7.5. Configure the Networking Service
7.5.1. Configure Networking Service Authentication
7.5.2. Configure RabbitMQ Message Broker Settings for the Networking Service
7.5.3. Set the Networking Service Plug-in
7.5.4. VXLAN and GRE tunnels
7.5.5. Configure Open vSwitch tunneling
7.5.6. Configure the Networking Service Database Connection
7.5.7. Create the OpenStack Networking Database
7.5.8. Launch the Networking Service
7.6. Configure the DHCP Agent
7.7. Create an External Network
7.8. Configuring the Plug-in Agent
7.8.1. Configure the Open vSwitch Plug-in Agent
7.8.2. Configure the Linux Bridge Plug-in Agent
7.9. Configure the L3 Agent
7.10. Validate the OpenStack Networking Installation
7.10.1. Troubleshoot OpenStack Networking Issues
8. OpenStack Compute Service Installation
8.1. Compute Service Overview
8.2. Compute Service Requirements
8.2.1. Check for Hardware Virtualization Support
8.3. Install a Compute VNC Proxy
8.3.1. Install the Compute VNC Proxy Packages
8.3.2. Configure the Firewall to Allow Compute VNC Proxy Traffic
8.3.3. Configure the VNC Proxy Service
8.3.4. Access Instances with the Compute VNC Proxy
8.4. Install a Compute Node
8.4.1. Create the Compute Service Database
8.4.2. Configure Compute Service Authentication
8.4.3. Install the Compute Service Packages
8.4.4. Configure the Compute Service to Use SSL
8.4.5. Configure the Compute Service
8.4.6. Populate the Compute Service Database
8.4.7. Launch the Compute Services
9. OpenStack Orchestration Installation
9.1. Orchestration Service Overview
9.2. Install the Orchestration Service Packages
9.3. Configure the Orchestration Service
9.3.1. Configure the Orchestration Service Database Connection
9.3.2. Restrict the Bind Addresses of each Orchestration API Service
9.3.3. Create the Orchestration Service Identity Records
9.3.4. Configure Orchestration Service Authentication
9.3.5. Configure RabbitMQ Message Broker Settings for the Orchestration Service
9.4. Launch the Orchestration Service
9.5. Deploy a Stack Using Orchestration Templates
9.6. Integrate Telemetry and Orchestration Services
10. Dashboard Installation
10.1. Dashboard Service Overview
10.2. Dashboard Service Requirements
10.3. Install the Dashboard Packages
10.4. Launch the Apache Web Service
10.5. Configure the Dashboard
10.5.1. Configure Connections and Logging
10.5.2. Configure the Dashboard to Use HTTPS
10.5.3. Change Dashboard's default role
10.5.4. Configure SELinux
10.5.5. Configure the Dashboard Firewall
10.5.6. Session Storage Options
10.6. Validate Dashboard Installation
10.6.1. OpenStack Dashboard - Admin Tab
10.6.2. OpenStack Dashboard - Project Tab
10.6.3. OpenStack Dashboard - Red Hat Access Tab
10.7. Troubleshoot Dashboard Installation Issues
10.7.1. No Networks or Routers Tab Appears in the Dashboard
10.7.2. Dashboard Reports ERROR When Launching Instances
11. OpenStack Sahara Installation
11.1. OpenStack Sahara Service Overview
11.2. Install the OpenStack Sahara Service Packages
11.3. Configure the Sahara Service
11.3.1. Configure the OpenStack Sahara Database Connection
11.3.2. Create the OpenStack Sahara Service Identity Records
11.3.3. Configure OpenStack Sahara Authentication
11.3.4. Configure the Firewall to Allow OpenStack Sahara Service Traffic
11.4. Configure and Launch the OpenStack Sahara Service
11.5. Install and Configure the OpenStack Sahara User Interface
III. Set Up the OpenStack Monitoring
12. OpenStack Telemetry Installation
12.1. Telemetry Service Overview
12.2. Overview of Telemetry Service Deployment
12.3. Install the Telemetry Service Packages
12.4. Create the Telemetry Identity Records
12.5. Configure Telemetry Service Authentication
12.6. Configure the Telemetry Database Connection
12.6.1. Configure and Launch the MongoDB Back-End
12.7. Configure the Compute Node
12.8. Configure Monitored Services
12.9. Launch the Telemetry API and Agents
13. Nagios Installation
13.1. Install the Nagios Service
13.1.1. Install the NRPE Addon
13.2. Configure Nagios
13.2.1. Configure HTTPD for Nagios
13.2.2. Configure Nagios to Monitor OpenStack Services
13.2.3. Configure NRPE
13.2.4. Create Host Definitions
13.2.5. Create Service Definitions for Remote Services
13.2.6. Verify the Nagios Configuration
14. Remote Logging Installation and Configuration
14.1. Introduction to Remote Logging
14.2. Install rsyslog Server
14.3. Configure rsyslog on the Centralized Logging Server
14.4. Configure rsyslog on Individual Nodes
14.5. Start the rsyslog Server
A. Appendix
A.1. Backup and Restore
A.1.1. Database Backup
A.1.2. File System Backup
A.1.3. Recovery
A.2. Miscellaneous Service Log Files
A.3. Manage Compute Expansion
A.3.1. Adding Compute Resources
A.3.2. Safely Remove Compute Resources
B. Revision History