Chapter 1. Introduction 1.1. About this release This release of Red Hat OpenStack Platform (RHOSP) is based on the OpenStack "Train" release. It includes additional features, known issues, and resolved issues specific to RHOSP. Only changes specific to RHOSP are included in this document. The release notes for the OpenStack "Train" release itself are available at the following location: https://releases.openstack.org/train/index.html . RHOSP uses components from other Red Hat products. For specific information pertaining to the support of these components, see https://access.redhat.com/site/support/policy/updates/openstack/platform/ . To evaluate RHOSP, sign up at http://www.redhat.com/openstack/ . Note The Red Hat Enterprise Linux High Availability Add-On is available for RHOSP use cases. For more details about the add-on, see http://www.redhat.com/products/enterprise-linux-add-ons/high-availability/ . For details about the package versions to use in combination with RHOSP, see https://access.redhat.com/site/solutions/509783 . 1.2. Requirements This version of Red Hat OpenStack Platform (RHOSP) runs on the most recent fully supported release of Red Hat Enterprise Linux 8.4. The dashboard for this release supports the latest stable versions of the following web browsers: Mozilla Firefox Mozilla Firefox ESR Google Chrome Note Before you deploy RHOSP, familiarize yourself with the recommended deployment methods. For more information, see Installing and Managing Red Hat OpenStack Platform . 1.3. Deployment limits For a list of deployment limits for Red Hat OpenStack Platform (RHOSP), see Deployment Limits for Red Hat OpenStack Platform . 1.4. Database size management For recommended practices on maintaining the size of the MariaDB databases in your Red Hat OpenStack Platform (RHOSP) environment, see Database Size Management for Red Hat Enterprise Linux OpenStack Platform . 1.5. Certified drivers and plug-ins For a list of the certified drivers and plug-ins in Red Hat OpenStack Platform (RHOSP), see Component, Plug-In, and Driver Support in Red Hat OpenStack Platform . 1.6. Certified guest operating systems For a list of the certified guest operating systems in Red Hat OpenStack Platform (RHOSP), see Certified Guest Operating Systems in Red Hat OpenStack Platform and Red Hat Enterprise Virtualization . 1.7. Product certification catalog For a list of the Red Hat Official Product Certification Catalog, see Product Certification Catalog . 1.8. Bare metal provisioning operating systems For a list of the guest operating systems that can be installed on bare metal nodes in Red Hat OpenStack Platform (RHOSP) through Bare Metal Provisioning (ironic), see Supported Operating Systems Deployable With Bare Metal Provisioning (ironic) . 1.9. Hypervisor support This release of the Red Hat OpenStack Platform (RHOSP) is supported only with the libvirt driver (using KVM as the hypervisor on Compute nodes). This release of the RHOSP runs with Bare Metal Provisioning. Bare Metal Provisioning has been fully supported since the release of RHOSP 7 (Kilo). You can use Bare Metal Provisioning to provision bare-metal machines by using common technologies such as PXE and IPMI, to cover a wide range of hardware while supporting pluggable drivers to allow the addition of vendor-specific functionality. Red Hat does not provide support for other Compute virtualization drivers such as the deprecated VMware "direct-to-ESX" hypervisor or non-KVM libvirt hypervisors. 1.10. Content Delivery Network (CDN) repositories This section describes the repositories required to deploy Red Hat OpenStack Platform (RHOSP) 16.2. You can install RHOSP 16.2 through the Content Delivery Network (CDN) using subscription-manager . For more information, see Preparing the undercloud . Warning Some packages in the RHOSP software repositories conflict with packages provided by the Extra Packages for Enterprise Linux (EPEL) software repositories. The use of RHOSP on systems with the EPEL software repositories enabled is unsupported. 1.10.1. Undercloud repositories RHOSP (RHOSP) 16.2 runs on Red Hat Enterprise Linux (RHEL) 8.4. As a result, you must lock the content from these repositories to the respective RHEL version. Note If you synchronize repositories by using Red Hat Satellite, you can enable specific versions of the RHEL repositories. However, the repository label remains the same despite the version you choose. For example, if you enable the 8.4 version of the BaseOS repository, the repository name includes the specific version that you enabled, but the repository label is still rhel-8-for-x86_64-baseos-eus-rpms . The advanced-virt-for-rhel-8-x86_64-rpms and advanced-virt-for-rhel-8-x86_64-eus-rpms repositories are no longer required. To disable these repositories, see the Red Hat Knowledgebase solution advanced-virt-for-rhel-8-x86_64-rpms are no longer required in OSP 16.2 . Warning Any repositories outside the ones specified here are not supported. Unless recommended, do not enable any other products or repositories outside the ones listed in the following tables or else you might encounter package dependency issues. Do not enable Extra Packages for Enterprise Linux (EPEL). Core repositories The following table lists core repositories for installing the undercloud. Name Repository Description of requirement Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-baseos-eus-rpms Base operating system repository for x86_64 systems. Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) rhel-8-for-x86_64-appstream-eus-rpms Contains RHOSP dependencies. Red Hat Enterprise Linux 8 for x86_64 - High Availability (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-highavailability-eus-rpms High availability tools for RHEL. Used for Controller node high availability. Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 (RPMs) ansible-2.9-for-rhel-8-x86_64-rpms Ansible Engine for RHEL. Used to provide the latest version of Ansible. RHOSP 16.2 for RHEL 8 (RPMs) openstack-16.2-for-rhel-8-x86_64-rpms Core RHOSP repository, which contains packages for RHOSP director. Red Hat Fast Datapath for RHEL 8 (RPMS) fast-datapath-for-rhel-8-x86_64-rpms Provides Open vSwitch (OVS) packages for OpenStack Platform. Ceph repositories The following table lists Ceph Storage related repositories for the undercloud. Name Repository Description of Requirement Red Hat Ceph Storage Tools 4 for RHEL 8 x86_64 (RPMs) rhceph-4-tools-for-rhel-8-x86_64-rpms Provides tools for nodes to communicate with the Ceph Storage cluster. The undercloud requires the ceph-ansible package from this repository if you plan to use Ceph Storage in your overcloud or if you want to integrate with an existing Ceph Storage cluster. IBM POWER repositories The following table contains a list of repositories for RHOSP on POWER PC architecture. Use these repositories in place of equivalents in the Core repositories. Name Repository Description of requirement Red Hat Enterprise Linux for IBM Power, little endian - BaseOS (RPMs) rhel-8-for-ppc64le-baseos-rpms Base operating system repository for ppc64le systems. Red Hat Enterprise Linux 8 for IBM Power, little endian - AppStream (RPMs) rhel-8-for-ppc64le-appstream-rpms Contains RHOSP dependencies. Red Hat Enterprise Linux 8 for IBM Power, little endian - High Availability (RPMs) rhel-8-for-ppc64le-highavailability-rpms High availability tools for RHEL. Used for Controller node high availability. Red Hat Fast Datapath for RHEL 8 IBM Power, little endian (RPMS) fast-datapath-for-rhel-8-ppc64le-rpms Provides Open vSwitch (OVS) packages for OpenStack Platform. Red Hat Ansible Engine 2.9 for RHEL 8 IBM Power, little endian (RPMs) ansible-2.9-for-rhel-8-ppc64le-rpms Ansible Engine for RHEL. Provides the latest version of Ansible. Red Hat OpenStack Platform 16.2 for RHEL 8 (RPMs) openstack-16.2-for-rhel-8-ppc64le-rpms Core RHOSP repository for ppc64le systems. 1.10.2. Overcloud repositories Red Hat OpenStack Platform (RHOSP) 16.2 runs on Red Hat Enterprise Linux (RHEL) 8.4. As a result, you must lock the content from these repositories to the respective RHEL version. Note If you synchronize repositories by using Red Hat Satellite, you can enable specific versions of the RHEL repositories. However, the repository label remains the same despite the version you choose. For example, if you enable the 8.4 version of the BaseOS repository, the repository name includes the specific version that you enabled, but the repository label is still rhel-8-for-x86_64-baseos-eus-rpms . The advanced-virt-for-rhel-8-x86_64-rpms and advanced-virt-for-rhel-8-x86_64-eus-rpms repositories are no longer required. To disable these repositories, see the Red Hat Knowledgebase solution advanced-virt-for-rhel-8-x86_64-rpms are no longer required in OSP 16.2 . Warning Any repositories outside the ones specified here are not supported. Unless recommended, do not enable any other products or repositories outside the ones listed in the following tables or else you might encounter package dependency issues. Do not enable Extra Packages for Enterprise Linux (EPEL). Controller node repositories The following table lists core repositories for Controller nodes in the overcloud. Name Repository Description of requirement Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-baseos-eus-rpms Base operating system repository for x86_64 systems. Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) rhel-8-for-x86_64-appstream-eus-rpms Contains RHOSP dependencies. Red Hat Enterprise Linux 8 for x86_64 - High Availability (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-highavailability-eus-rpms High availability tools for RHEL. Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 (RPMs) ansible-2.9-for-rhel-8-x86_64-rpms Ansible Engine for RHEL. Used to provide the latest version of Ansible. Red Hat OpenStack Platform 16.2 for RHEL 8 (RPMs) openstack-16.2-for-rhel-8-x86_64-rpms Core RHOSP repository. Red Hat Fast Datapath for RHEL 8 (RPMS) fast-datapath-for-rhel-8-x86_64-rpms Provides Open vSwitch (OVS) packages for OpenStack Platform. Red Hat Ceph Storage Tools 4 for RHEL 8 x86_64 (RPMs) rhceph-4-tools-for-rhel-8-x86_64-rpms Tools for Red Hat Ceph Storage 4 for RHEL 8. Compute and ComputeHCI node repositories The following table lists core repositories for Compute and ComputeHCI nodes in the overcloud. Name Repository Description of requirement Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-baseos-eus-rpms Base operating system repository for x86_64 systems. Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) rhel-8-for-x86_64-appstream-eus-rpms Contains RHOSP dependencies. Red Hat Enterprise Linux 8 for x86_64 - High Availability (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-highavailability-eus-rpms High availability tools for RHEL. Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 (RPMs) ansible-2.9-for-rhel-8-x86_64-rpms Ansible Engine for RHEL. Used to provide the latest version of Ansible. Red Hat OpenStack Platform 16.2 for RHEL 8 (RPMs) openstack-16.2-for-rhel-8-x86_64-rpms Core RHOSP repository. Red Hat Fast Datapath for RHEL 8 (RPMS) fast-datapath-for-rhel-8-x86_64-rpms Provides Open vSwitch (OVS) packages for OpenStack Platform. Red Hat Ceph Storage Tools 4 for RHEL 8 x86_64 (RPMs) rhceph-4-tools-for-rhel-8-x86_64-rpms Tools for Red Hat Ceph Storage 4 for RHEL 8. Real Time Compute repositories The following table lists repositories for Real Time Compute (RTC) functionality. Name Repository Description of requirement Red Hat Enterprise Linux 8 for x86_64 - Real Time (RPMs) rhel-8-for-x86_64-rt-rpms Repository for Real Time KVM (RT-KVM). Contains packages to enable the real time kernel. Enable this repository for all Compute nodes targeted for RT-KVM. NOTE: You need a separate subscription to a Red Hat OpenStack Platform for Real Time SKU to access this repository. Red Hat Enterprise Linux 8 for x86_64 - Real Time for NFV (RPMs) rhel-8-for-x86_64-nfv-rpms Repository for Real Time KVM (RT-KVM) for NFV. Contains packages to enable the real time kernel. Enable this repository for all NFV Compute nodes targeted for RT-KVM. NOTE: You need a separate subscription to a Red Hat OpenStack Platform for Real Time SKU to access this repository. Ceph Storage node repositories The following table lists Ceph Storage related repositories for the overcloud. Name Repository Description of requirement Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs) rhel-8-for-x86_64-baseos-rpms Base operating system repository for x86_64 systems. Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) rhel-8-for-x86_64-appstream-rpms Contains RHOSP dependencies. Red Hat Enterprise Linux 8 for x86_64 - High Availability (RPMs) Extended Update Support (EUS) rhel-8-for-x86_64-highavailability-eus-rpms High availability tools for RHEL. NOTE: If you used the overcloud-full image for your Ceph Storage role, you must enable this repository. Ceph Storage roles should use the overcloud-minimal image, which does not require this repository. Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 (RPMs) ansible-2.9-for-rhel-8-x86_64-rpms Ansible Engine for RHEL. Used to provide the latest version of Ansible. Red Hat OpenStack Platform 16.2 Director Deployment Tools for RHEL 8 x86_64 (RPMs) openstack-16.2-deployment-tools-for-rhel-8-x86_64-rpms Packages to help director configure Ceph Storage nodes. This repository is included with standalone Ceph Storage subscriptions. If you use a combined OpenStack Platform and Ceph Storage subscription, use the openstack-16.2-for-rhel-8-x86_64-rpms repository. Red Hat OpenStack Platform 16.2 for RHEL 8 (RPMs) openstack-16.2-for-rhel-8-x86_64-rpms Packages to help director configure Ceph Storage nodes. This repository is included with combined OpenStack Platform and Ceph Storage subscriptions. If you use a standalone Ceph Storage subscription, use the openstack-16.2-deployment-tools-for-rhel-8-x86_64-rpms repository. Red Hat Ceph Storage Tools 4 for RHEL 8 x86_64 (RPMs) rhceph-4-tools-for-rhel-8-x86_64-rpms Provides tools for nodes to communicate with the Ceph Storage cluster. Red Hat Fast Datapath for RHEL 8 (RPMS) fast-datapath-for-rhel-8-x86_64-rpms Provides Open vSwitch (OVS) packages for OpenStack Platform. If you are using OVS on Ceph Storage nodes, add this repository to the network interface configuration (NIC) templates. IBM POWER repositories The following table lists repositories for RHOSP on POWER PC architecture. Use these repositories in place of equivalents in the Core repositories. Name Repository Description of requirement Red Hat Enterprise Linux for IBM Power, little endian - BaseOS (RPMs) rhel-8-for-ppc64le-baseos-rpms Base operating system repository for ppc64le systems. Red Hat Enterprise Linux 8 for IBM Power, little endian - AppStream (RPMs) rhel-8-for-ppc64le-appstream-rpms Contains RHOSP dependencies. Red Hat Enterprise Linux 8 for IBM Power, little endian - High Availability (RPMs) rhel-8-for-ppc64le-highavailability-rpms High availability tools for RHEL. Used for Controller node high availability. Red Hat Fast Datapath for RHEL 8 IBM Power, little endian (RPMS) fast-datapath-for-rhel-8-ppc64le-rpms Provides Open vSwitch (OVS) packages for OpenStack Platform. Red Hat Ansible Engine 2.9 for RHEL 8 IBM Power, little endian (RPMs) ansible-2.9-for-rhel-8-ppc64le-rpms Ansible Engine for RHEL. Used to provide the latest version of Ansible. Red Hat OpenStack Platform 16.2 for RHEL 8 (RPMs) openstack-16.2-for-rhel-8-ppc64le-rpms Core RHOSP repository for ppc64le systems. 1.11. Streamlined container build In Red Hat OpenStack Platform (RHOSP) 16.2 the container build has been streamlined. As a result, several containers have been removed: registry.redhat.io/rhosp-rhel8/openstack-glance-base registry.redhat.io/rhosp-rhel8/openstack-rsyslog-base registry.redhat.io/rhosp-rhel8/openstack-panko-base registry.redhat.io/rhosp-rhel8/openstack-keystone-base registry.redhat.io/rhosp-rhel8/openstack-openvswitch-base registry.redhat.io/rhosp-rhel8/openstack-redis-base registry.redhat.io/rhosp-rhel8/openstack-placement-base registry.redhat.io/rhosp-rhel8/openstack-zaqar-base 1.12. Product support Available resources include: Customer Portal The Red Hat Customer Portal offers a wide range of resources to help guide you through planning, deploying, and maintaining your Red Hat OpenStack Platform (RHOSP) deployment. Facilities available through the Customer Portal include: Product documentation Knowledge base articles and solutions Technical briefs Support case management Access the Customer Portal at https://access.redhat.com/ . Mailing Lists Red Hat provides these public mailing lists that are relevant to RHOSP users: The rhsa-announce mailing list provides notification of the release of security fixes for all Red Hat products, including RHOSP. Subscribe at https://www.redhat.com/mailman/listinfo/rhsa-announce . 1.13. Unsupported features The following features are not supported in Red Hat OpenStack Platform (RHOSP): Custom policies, which includes modification of policy.json files either manually or through any *Policies heat parameters. Do not modify the default policies unless the documentation contains explicit instructions to do so. Containers are not available for the following packages, therefore they are not supported in RHOSP: nova-serialproxy nova-spicehtml5proxy File injection of personality files to inject user data into virtual machine instances. Instead, cloud users can pass data to their instances by using the --user-data option to run a script during instance boot, or set instance metadata by using the --property option when launching an instance. For more information, see Creating a customized instance . If you require support for any of these features, please contact the Red Hat Customer Experience and Engagement team to obtain a support exception.

Commands: