37393e80bb
Also adds missing note about pre-release packages for SUSE distros. Change-Id: Ib3acecc87cd180dff6dce7421cdf9c059ece51d9
255 lines
6.6 KiB
ReStructuredText
255 lines
6.6 KiB
ReStructuredText
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.
|
|
|
|
.. 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.
|
|
|
|
.. only:: ubuntu
|
|
|
|
Enable the OpenStack repository
|
|
-------------------------------
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get install software-properties-common
|
|
# add-apt-repository cloud-archive:newton
|
|
|
|
.. note::
|
|
|
|
For pre-release testing, use the staging repository:
|
|
|
|
.. code-block:: console
|
|
|
|
# add-apt-repository cloud-archive:newton-proposed
|
|
|
|
.. only:: rdo
|
|
|
|
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::
|
|
|
|
CentOS does not require the following steps.
|
|
|
|
#. On RHEL, register your system with Red Hat Subscription Management, using
|
|
your Customer Portal user name and password:
|
|
|
|
.. code-block:: console
|
|
|
|
# subscription-manager register --username="USERNAME" --password="PASSWORD"
|
|
|
|
#. Find entitlement pools containing the channels for your RHEL system:
|
|
|
|
.. code-block:: console
|
|
|
|
# subscription-manager list --available
|
|
|
|
#. Use the pool identifiers found in the previous step to attach your RHEL
|
|
entitlements:
|
|
|
|
.. code-block:: console
|
|
|
|
# subscription-manager attach --pool="POOLID"
|
|
|
|
#. Enable required repositories:
|
|
|
|
.. 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
|
|
|
|
.. only:: rdo
|
|
|
|
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-newton
|
|
|
|
* 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
|
|
|
|
.. note::
|
|
|
|
For pre-release testing on CentOS or RHEL, install the
|
|
``yum-plugin-priorities`` package so that the Delorean repository takes
|
|
precedence over the main RDO repositories, and use the Delorean
|
|
repositories:
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install yum-plugin-priorities
|
|
# cd /etc/yum.repos.d/
|
|
# curl -O http://trunk.rdoproject.org/centos7/delorean-deps.repo
|
|
# curl -O http://trunk.rdoproject.org/centos7/current-passed-ci/delorean.repo
|
|
|
|
.. only:: obs
|
|
|
|
Enable the OpenStack repository
|
|
-------------------------------
|
|
|
|
* Enable the Open Build Service repositories based on your openSUSE or
|
|
SLES version:
|
|
|
|
**On openSUSE:**
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper addrepo -f obs://Cloud:OpenStack:Newton/openSUSE_Leap_42.1 Newton
|
|
|
|
.. note::
|
|
|
|
For pre-release testing, use the master repository:
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper addrepo -f obs://Cloud:OpenStack:Master/openSUSE_Leap_42.1 Master
|
|
|
|
The openSUSE distribution uses the concept of patterns to represent
|
|
collections of packages. If you selected 'Minimal Server Selection (Text
|
|
Mode)' during the initial installation, you may be presented with a
|
|
dependency conflict when you attempt to install the OpenStack packages.
|
|
To avoid this, remove the minimal\_base-conflicts package:
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper rm patterns-openSUSE-minimal_base-conflicts
|
|
|
|
**On SLES:**
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper addrepo -f obs://Cloud:OpenStack:Newton/SLE_12_SP1 Newton
|
|
|
|
.. note::
|
|
|
|
The packages are signed by GPG key ``D85F9316``. You should
|
|
verify the fingerprint of the imported GPG key before using it.
|
|
|
|
.. code-block:: console
|
|
|
|
Key Name: Cloud:OpenStack OBS Project <Cloud:OpenStack@build.opensuse.org>
|
|
Key Fingerprint: 35B34E18 ABC1076D 66D5A86B 893A90DA D85F9316
|
|
Key Created: 2015-12-16T16:48:37 CET
|
|
Key Expires: 2018-02-23T16:48:37 CET
|
|
|
|
.. note::
|
|
|
|
For pre-release testing, use the master repository:
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper addrepo -f obs://Cloud:OpenStack:Master/SLE_12_SP1 Master
|
|
|
|
.. only:: debian
|
|
|
|
Enable the backports repository
|
|
-------------------------------
|
|
|
|
The Newton release is available directly through the official
|
|
Debian backports repository. To use this repository, follow
|
|
the instruction from the official
|
|
`Debian website <http://backports.debian.org/Instructions/>`_,
|
|
which basically suggest doing the following steps:
|
|
|
|
#. On all nodes, adding the Debian 8 (Jessie) backport repository to
|
|
the source list:
|
|
|
|
.. code-block:: console
|
|
|
|
# echo "deb http://http.debian.net/debian jessie-backports main" \
|
|
>>/etc/apt/sources.list
|
|
|
|
.. note::
|
|
|
|
Later you can use the following command to install a package:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get -t jessie-backports install ``PACKAGE``
|
|
|
|
Finalize the installation
|
|
-------------------------
|
|
|
|
1. Upgrade the packages on your host:
|
|
|
|
.. only:: ubuntu or debian
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get update && apt-get dist-upgrade
|
|
|
|
.. only:: rdo
|
|
|
|
.. code-block:: console
|
|
|
|
# yum upgrade
|
|
|
|
.. only:: obs
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper refresh && zypper dist-upgrade
|
|
|
|
.. note::
|
|
|
|
If the upgrade process includes a new kernel, reboot your host
|
|
to activate it.
|
|
|
|
2. Install the OpenStack client:
|
|
|
|
.. only:: debian or ubuntu
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get install python-openstackclient
|
|
|
|
.. only:: rdo
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install python-openstackclient
|
|
|
|
.. only:: obs
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper install python-openstackclient
|
|
|
|
.. only:: rdo
|
|
|
|
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
|