diff --git a/doc/install-guide/source/environment-memcached-rdo.rst b/doc/install-guide/source/environment-memcached-rdo.rst index c6de5a57f3..34ee0483e1 100644 --- a/doc/install-guide/source/environment-memcached-rdo.rst +++ b/doc/install-guide/source/environment-memcached-rdo.rst @@ -11,10 +11,18 @@ Install and configure components #. Install the packages: + **For CentOS 7 and RHEL 7** + .. code-block:: console # yum install memcached python-memcached + **For CentOS 8 and RHEL 8** + + .. code-block:: console + + # yum install memcached python3-memcached + 2. Edit the ``/etc/sysconfig/memcached`` file and complete the following actions: diff --git a/doc/install-guide/source/environment-packages-rdo.rst b/doc/install-guide/source/environment-packages-rdo.rst index 54d3077f36..c2b6b5a530 100644 --- a/doc/install-guide/source/environment-packages-rdo.rst +++ b/doc/install-guide/source/environment-packages-rdo.rst @@ -5,6 +5,13 @@ Distributions release OpenStack packages as part of the distribution or using other methods because of differing release schedules. Perform these procedures on all nodes. +.. warning:: + + Starting with the Ussuri release, you will need to use either CentOS8 + or RHEL 8. Previous OpenStack releases will need to use either CentOS7 + or RHEL 7. Instructions are included for both distributions and + versions where different. + .. note:: The set up of OpenStack packages described here needs to be done on @@ -36,34 +43,69 @@ Prerequisites #. When using RHEL, it is assumed that you have registered your system using Red Hat Subscription Management and that you have the - ``rhel-7-server-rpms`` repository enabled by default. + ``rhel-7-server-rpms`` or ``rhel-8-for-x86_64-baseos-rpms`` repository + enabled by default depending on your version. - For more information on registering the system, see the + For more information on registering a RHEL 7 system, see the `Red Hat Enterprise Linux 7 System Administrator's Guide `_. -#. In addition to ``rhel-7-server-rpms``, you also need to have the - ``rhel-7-server-optional-rpms``, ``rhel-7-server-extras-rpms``, and - ``rhel-7-server-rh-common-rpms`` repositories enabled: +#. In addition to ``rhel-7-server-rpms`` on a RHEL 7 system, you also need to + have the ``rhel-7-server-optional-rpms``, ``rhel-7-server-extras-rpms``, + and ``rhel-7-server-rh-common-rpms`` repositories enabled: .. code-block:: console # subscription-manager repos --enable=rhel-7-server-optional-rpms \ --enable=rhel-7-server-extras-rpms --enable=rhel-7-server-rh-common-rpms + For more information on registering a RHEL 8 system, see the + `Red Hat Enterprise Linux 8 Installation Guide + `_. + + In addition to ``rhel-8-for-x86_64-baseos-rpms`` on a RHEL 8 system, you + also need to have the ``rhel-8-for-x86_64-appstream-rpms``, + ``rhel-8-for-x86_64-supplementary-rpms``, and ``codeready-builder-for-rhel-8-x86_64-rpms`` + repositories enabled: + + .. code-block:: console + + # subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms \ + --enable=rhel-8-for-x86_64-supplementary-rpms --enable=codeready-builder-for-rhel-8-x86_64-rpms + Enable the OpenStack repository ------------------------------- * On CentOS, the ``extras`` repository provides the RPM that enables the OpenStack repository. CentOS includes the ``extras`` repository by default, so you can simply install the package to enable the OpenStack + repository. For CentOS8, you will also need to enable the PowerTools repository. + **When installing the Ussuri release, run:** + + .. code-block:: console + + # yum install centos-release-openstack-ussuri + # yum config-manager --set-enabled PowerTools + + **When installing the Train release, run:** + + .. code-block:: console + + # yum install centos-release-openstack-train + + **When installing the Stein release, run:** + + .. code-block:: console + + # yum install centos-release-openstack-stein + **When installing the Rocky release, run:** .. code-block:: console - # yum install centos-release-openstack-rocky + # yum install centos-release-openstack-rocky **When installing the Queens release, run:** @@ -100,12 +142,20 @@ Finalize the installation If the upgrade process includes a new kernel, reboot your host to activate it. -2. Install the OpenStack client: +2. Install the appropriate OpenStack client for your version. + + **For CentOS 7 and RHEL 7** .. code-block:: console # yum install python-openstackclient + **For CentOS 8 and RHEL 8** + + .. code-block:: console + + # yum install python3-openstackclient + 3. RHEL and CentOS enable :term:`SELinux` by default. Install the ``openstack-selinux`` package to automatically manage security policies for OpenStack services: diff --git a/doc/install-guide/source/preface.rst b/doc/install-guide/source/preface.rst index 7e6f1c40de..47f30dc24e 100644 --- a/doc/install-guide/source/preface.rst +++ b/doc/install-guide/source/preface.rst @@ -47,8 +47,14 @@ openSUSE and SUSE Linux Enterprise Server Service Cloud repository. Red Hat Enterprise Linux and CentOS - You can install OpenStack by using packages available on Red Hat - Enterprise Linux 7 and its derivatives through the RDO repository. + You can install OpenStack by using packages available on both Red + Hat Enterprise Linux 7 and 8 and their derivatives through the RDO + repository. + + ..note:: + + OpenStack Ussuri is available for both CentOS 8 and RHEL 8. OpenStack + Train and earlier are available on both CentOS 7 and RHEL 7. Ubuntu You can walk through an installation by using packages available through