openstack-manuals/doc/install-guide/source/environment-packages.rst

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.

ubuntu

Enable the OpenStack repository

# apt-get install software-properties-common
# add-apt-repository cloud-archive:mitaka

Note

For pre-release testing, use the staging repository:

# add-apt-repository cloud-archive:mitaka-proposed

rdo

Prerequisites

Warning

It is recommended to disable EPEL when using RDO packages due to some updates in EPEL breaking backwards compatibility. Or preferably pin packages versions using the yum-versionlock plugin

1. On RHEL, enable additional repositories using the subscription manager:

   # subscription-manager repos --enable=rhel-7-server-optional-rpms
   # subscription-manager repos --enable=rhel-7-server-extras-rpms

   Note

   CentOS does not require these repositories.

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.

  # yum install centos-release-openstack-mitaka

• On RHEL, download and install the RDO repository RPM to enable the OpenStack repository.

  # yum install https://rdoproject.org/repos/openstack-liberty/rdo-release-mitaka.rpm

Note

For pre-release testing on CentOS or RHEL, use the delorean repositories:

# yum install yum-plugin-priorities
# wget http://trunk.rdoproject.org/centos7/delorean-deps.repo
# wget http://trunk.rdoproject.org/centos7/current-passed-ci/delorean.repo

obs

Enable the OpenStack repository

• Enable the Open Build Service repositories based on your openSUSE or SLES version:

  On openSUSE:

  # zypper addrepo -f obs://Cloud:OpenStack:Mitaka/openSUSE_Leap_42.1 Mitaka

  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:

  # zypper rm patterns-openSUSE-minimal_base-conflicts

  On SLES:

  # zypper addrepo -f obs://Cloud:OpenStack:Mitaka/SLE_12_SP1 Mitaka

  Note

  The packages are signed by GPG key D85F9316. You should verify the fingerprint of the imported GPG key before using it.

  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

debian

Enable the backports repository

The Liberty 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:

1. On all nodes, adding the Debian 8 (Jessie) backport repository to the source list:

   # 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:

   # apt-get -t jessie-backports install ``PACKAGE``

Finalize the installation

1. Upgrade the packages on your host:

   ubuntu or debian

   # apt-get update && apt-get dist-upgrade

   rdo

   # yum upgrade

   obs

   # 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:

   debian or ubuntu

   # apt-get install python-openstackclient

   rdo

   # yum install python-openstackclient

   obs

   # zypper install python-openstackclient

rdo

3. RHEL and CentOS enable SELinux by default. Install the openstack-selinux package to automatically manage security policies for OpenStack services:

   # yum install openstack-selinux