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 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 `_, 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