e39304d4ae
The PDF build does not include content multiple times if the same file is included in a toctree more than once. That means we need to restructure the guide to handle the common parts differently. This approach merges some of the previously split sections back together using inline prose to indicate where minor variations apply for different operating systems but retaining separate files for cases where the differences are significant. Change-Id: I5d9ff549b05ca4ce54486719d70858589b8fcfa3 Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
128 lines
3.0 KiB
ReStructuredText
128 lines
3.0 KiB
ReStructuredText
Red Hat OpenStack packages
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Distributions release OpenStack packages as part of the distribution or
|
|
using other methods because of differing release schedules. Perform
|
|
these procedures on all nodes.
|
|
|
|
.. note::
|
|
|
|
The set up of OpenStack packages described here needs to be done on
|
|
all nodes: controller, compute, and Block Storage nodes.
|
|
|
|
.. warning::
|
|
|
|
Your hosts must contain the latest versions of base installation
|
|
packages available for your distribution before proceeding further.
|
|
|
|
.. note::
|
|
|
|
Disable or remove any automatic update services because they can
|
|
impact your OpenStack environment.
|
|
|
|
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
.. warning::
|
|
|
|
We recommend disabling EPEL when using RDO packages due to updates
|
|
in EPEL breaking backwards compatibility. Or, preferably pin package
|
|
versions using the ``yum-versionlock`` plugin.
|
|
|
|
.. note::
|
|
|
|
The following steps apply to RHEL only. CentOS does not require these
|
|
steps.
|
|
|
|
#. 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.
|
|
|
|
For more information on registering the system, see the
|
|
`Red Hat Enterprise Linux 7 System Administrator's Guide
|
|
<https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/part-Subscription_and_Support.html>`_.
|
|
|
|
#. 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:
|
|
|
|
.. 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
|
|
|
|
.. end
|
|
|
|
|
|
|
|
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.
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install centos-release-openstack-ocata
|
|
|
|
.. end
|
|
|
|
* On RHEL, download and install the RDO repository RPM to enable the
|
|
OpenStack repository.
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install https://rdoproject.org/repos/rdo-release.rpm
|
|
|
|
.. end
|
|
|
|
|
|
|
|
Finalize the installation
|
|
-------------------------
|
|
|
|
1. Upgrade the packages on all nodes:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
# yum upgrade
|
|
|
|
.. end
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
If the upgrade process includes a new kernel, reboot your host
|
|
to activate it.
|
|
|
|
2. Install the OpenStack client:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install python-openstackclient
|
|
|
|
.. end
|
|
|
|
|
|
|
|
|
|
3. RHEL and CentOS enable :term:`SELinux` by default. Install the
|
|
``openstack-selinux`` package to automatically manage security
|
|
policies for OpenStack services:
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install openstack-selinux
|
|
|
|
.. end
|
|
|