Chapter 1. Introduction

This document provides a reference for how components in a Red Hat OpenStack Platform environment are installed and configured. Installation and configuration information is grouped by component for the following components:
  • The MariaDB Database Service
  • The RabbitMQ Message Broker
  • The Identity Service
  • The Object Storage Service
  • The Image Service
  • The Block Storage Service
  • OpenStack Networking
  • The Compute Service
  • The Orchestration Service
  • The Dashboard
  • The Data Processing Service
  • The Telemetry Service
  • The Time-Series-as-a-Service
  • The File Share Service (Technology Preview)
  • The Database-as-a-Service (Technology Preview)

Note

For an overview of the OpenStack components and their interfaces, see the Architecture Guide (https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/).
The document includes tasks, such as database setup and firewall configuration, that are common to all components, and tasks that are specific to configuring each component.

⁠1.1. Subscribe to the Required Channels

To install Red Hat OpenStack Platform, you must register all systems in the OpenStack environment with Red Hat Subscription Manager, and subscribe to the required channels.
⁠

Procedure 1.1. Subscribing to the Required Channels

  1. Register your system with the Content Delivery Network, entering your Customer Portal user name and password when prompted: 
    # subscription-manager register
  2. Find entitlement pools containing the channels required to install Red Hat OpenStack Platform: 
    # subscription-manager list --available | grep -A8 "Red Hat Enterprise Linux Server"
# subscription-manager list --available | grep -A8 "Red Hat Enterprise Linux OpenStack Platform"
  3. Use the pool identifiers located in the previous step to attach the Red Hat Enterprise Linux 7 Server and Red Hat Enterprise Linux OpenStack Platform entitlements: 
    # subscription-manager attach --pool=pool_id
  4. Enable the required channels: 
    # subscription-manager repos --enable=rhel-7-server-rpms \
--enable=rhel-7-server-openstack-8.0-rpms \
--enable=rhel-7-server-optional-rpms \
--enable=rhel-7-server-rh-common-rpms \
--enable=rhel-7-server-openstack-7.0-optools-rpms
  5. Install the yum-plugin-priorities package provided by the rhel-7-server-optional-rpms channel: 
    # yum install yum-plugin-priorities
  6. If not yet installed, use the following to install yum-config-manager: 
    # yum install yum-utils
  7. Use the yum-config-manager command to set the priority of the Red Hat Enterprise Linux OpenStack Platform software repository to 1. This is the highest priority value supported by the yum-plugin-priorities plug-in. 
    # yum-config-manager --enable reponame --setopt="reponame.priority=1"
    For example: 
    # yum-config-manager --enable rhel-7-server-openstack-8.0-rpms \
--setopt="rhel-7-server-openstack-8.0-rpms.priority=1"
Loaded plugins: product-id
==== repo: rhel-7-server-openstack-8.0-rpms ====
[rhel-7-server-openstack-8.0-rpms]
bandwidth = 0
base_persistdir = /var/lib/yum/repos/x86_64/6Server
...
cost = 1000
enabled = True
...
priority = 1
...
    Repeat this step and set the priority as 1 for the following Red Hat Enterprise Linux OpenStack Platform software repositories:
    • rhel-7-server-openstack-7.0-tools-rpms
    • rhel-7-server-openstack-7.0-optools-rpms
  8. Run the yum update command and reboot to ensure that the most up-to-date packages, including the kernel, are installed and running. 
    # yum update
# reboot
You have successfully configured your system to receive Red Hat OpenStack Platform packages. You may use the yum repolist command to confirm the repository configuration again at any time.