Chapter 1. Introduction

This document provides a reference for how components in a Red Hat Enterprise Linux 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 File Share 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 RHEL 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. Obtain detailed information about the Red Hat OpenStack Platform subscription available to you:
    # subscription-manager list --available --matches '*OpenStack Platform*'
    This command should print output similar to the following:
    +-------------------------------------------+
        Available Subscriptions
    +-------------------------------------------+
    Subscription Name:   Red Hat Enterprise Linux OpenStack Platform, Standard (2-sockets)
    Provides:            Red Hat Beta
    ...
                         Red Hat OpenStack
    ...
    SKU:                 ABC1234
    Contract:            12345678
    Pool ID:             0123456789abcdef0123456789abcdef
    Provides Management: No
    Available:           Unlimited
    Suggested:           1
    Service Level:       Standard
    Service Type:        L1-L3
    Subscription Type:   Stackable
    Ends:                12/31/2099
    System Type:         Virtual
  3. Use the Pool ID printed by this command to attach the Red Hat OpenStack Platform entitlement:
    # subscription-manager attach --pool=Pool ID
  4. Disable any irrelevant and enable the required channels:
    # subscription-manager repos --disable=\* \
    --enable=rhel-7-server-rpms \
    --enable=rhel-7-server-openstack-7.0-rpms \
    --enable=rhel-7-server-rh-common-rpms
    
  5. 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 Enterprise Linux OpenStack Platform packages. You may use the yum repolist command to confirm the repository configuration again at any time.