openstack-manuals/doc/install-guide/source/environment-packages.rst
Tom Fifield a85c15b6ba Fix incorrect ordering of install packaging section
Change https://review.openstack.org/#/c/237899/ reordered various
aspects of the environment sections in the install guide and
inadvertently re-ordered the packaging section.

As reported by Timo Henriksson, after installing the repositories,
the package list must be updated before clients can be installed.
If this is not done, incorrect and incompatible versions will be used.

Change-Id: Ifac6d788105f535cdddff3161d0691d50cc12d62
Closes-Bug: 1508409
2015-10-22 14:16:03 +08:00

5.2 KiB

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

rdo

Prerequisites

  1. Enable the EPEL repository:

    # yum install http://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-5.noarch.rpm
  2. 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

  • Install the rdo-release-liberty package to enable the RDO repository:

    # yum install http://rdo.fedorapeople.org/openstack-liberty/rdo-release-liberty.rpm

obs

Enable the OpenStack repository

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

    On openSUSE 13.2:

    # zypper addrepo -f obs://Cloud:OpenStack:Liberty/openSUSE_13.2 Liberty

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

    # zypper addrepo -f obs://Cloud:OpenStack:Liberty/SLE_12 Liberty

    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:      Tue 08 Oct 2013 01:34:21 PM UTC
    Key Expires:      Thu 17 Dec 2015 01:34:21 PM UTC

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

ubuntu or debian

  • Upgrade the packages on your system:

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

    Note

    If the upgrade process includes a new kernel, reboot your system to activate it.

rdo

  1. Upgrade the packages on your system:

    # yum upgrade

    Note

    If the upgrade process includes a new kernel, reboot your system to activate it.

obs

  • Upgrade the packages on your system:

    # zypper refresh && zypper dist-upgrade

    Note

    If the upgrade process includes a new kernel, reboot your system to activate it.

rdo

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

    # yum install openstack-selinux

Install the OpenStack client

Throughout the guide the OpenStack client will be used to perform actions on the installed services.

  • Install the package:

debian or ubuntu

# apt-get install python-openstackclient

rdo

# yum install python-openstackclient

obs

# zypper install python-openstackclient