openstack-manuals/doc/install-guide/section_basics-packages.xml

<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:xlink="http://www.w3.org/1999/xlink"
  version="5.0"
  xml:id="basics-packages">
  <?dbhtml stop-chunking?>
  <title>OpenStack packages</title>
  <para>Distributions release OpenStack packages as part of the distribution
    or using other methods because of differing release schedules. Perform
    these procedures on all nodes.</para>
  <note>
    <para>Disable or remove any automatic update services because they can
      impact your OpenStack environment.</para>
  </note>
  <procedure os="ubuntu">
    <title>To enable the OpenStack repository</title>
    <step>
      <para>Install the Ubuntu Cloud archive keyring and repository:</para>
      <screen><prompt>#</prompt> <userinput>apt-get install ubuntu-cloud-keyring</userinput>
<prompt>#</prompt> <userinput>echo "deb http://ubuntu-cloud.archive.canonical.com/ubuntu" \
  "trusty-updates/kilo main" > /etc/apt/sources.list.d/cloudarchive-kilo.list</userinput></screen>
    </step>
  </procedure>
  <procedure os="rhel;centos;fedora">
    <title>To configure prerequisites</title>
    <step>
      <para>On RHEL and CentOS, enable the
        <link
        xlink:href="https://fedoraproject.org/wiki/EPEL">EPEL</link> repository:</para>
      <screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-5.noarch.rpm</userinput></screen>
      <note>
        <para>Fedora does not require this repository.</para>
      </note>
    </step>
    <step>
      <para>On RHEL, enable additional repositories using the subscription
        manager:</para>
      <screen><prompt>#</prompt> <userinput>subscription-manager repos --enable=rhel-7-server-optional-rpms</userinput>
<prompt>#</prompt> <userinput>subscription-manager repos --enable=rhel-7-server-extras-rpms</userinput></screen>
      <note>
        <para>CentOS and Fedora do not require these repositories.</para>
      </note>
    </step>
  </procedure>
  <procedure os="rhel;centos;fedora">
    <title>To enable the OpenStack repository</title>
    <step>
      <para>Install the <package>rdo-release-kilo</package> package to enable
        the RDO repository:</para>
      <screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://rdo.fedorapeople.org/openstack-kilo/rdo-release-kilo.rpm</userinput></screen>
    </step>
  </procedure>
  <procedure os="sles;opensuse">
    <title>To enable the OpenStack repository</title>
    <step>
      <para>Enable the Open Build Service repositories based on your openSUSE
        or SLES version:</para>
      <para>On openSUSE 13.2:</para>
      <screen><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Kilo/openSUSE_13.2 Kilo</userinput></screen>
      <para>The openSUSE distribution uses the concept of patterns to represent
        collections of packages. If you selected 'Minimal Server Selection (Text Mode)'
        during 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:</para>
      <screen><prompt>#</prompt> <userinput>zypper rm patterns-openSUSE-minimal_base-conflicts</userinput></screen>
      <para>On SLES 12:</para>
      <screen><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Kilo/SLE_12 Kilo</userinput></screen>
      <note>
        <para>The packages are signed by GPG key 893A90DAD85F9316. You should
          verify the fingerprint of the imported GPG key before using
          it.</para>
        <programlisting>Key ID: 893A90DAD85F9316
Key Name: Cloud:OpenStack OBS Project &lt;Cloud:OpenStack@build.opensuse.org&gt;
Key Fingerprint: 35B34E18ABC1076D66D5A86B893A90DAD85F9316
Key Created: Tue Oct  8 13:34:21 2013
Key Expires: Thu Dec 17 13:34:21 2015</programlisting>
      </note>
    </step>
  </procedure>
  <procedure os="debian">
    <title>To use the Debian Wheezy backports archive for
      Juno</title>
    <para>The <glossterm>Juno</glossterm> release is available
      only in Debian Experimental (otherwise called rc-buggy),
      as Jessie is frozen soon, and will contain Icehouse.
      However, the Debian maintainers
      of OpenStack also maintain a non-official Debian repository
      for OpenStack containing Wheezy backports.</para>
    <step>
      <para>On all nodes, install the Debian Wheezy backport repository
        Juno:</para>
      <screen><prompt>#</prompt> <userinput>echo "deb http://archive.gplhost.com/debian juno-backports main" >>/etc/apt/sources.list</userinput></screen>
    </step>
    <step>
      <para>Install the Debian Wheezy OpenStack repository for
        Juno:</para>
      <screen><prompt>#</prompt> <userinput>echo "deb http://archive.gplhost.com/debian juno main" >>/etc/apt/sources.list</userinput></screen>
    </step>
    <step>
      <para>Update the repository database and install the key:</para>
      <screen><prompt>#</prompt> <userinput>apt-get update &amp;&amp; apt-get install gplhost-archive-keyring</userinput></screen>
    </step>
    <step>
      <para>Update the package database, upgrade your system, and reboot
        for all changes to take effect:</para>
      <screen><prompt>#</prompt> <userinput>apt-get update &amp;&amp; apt-get dist-upgrade</userinput>
<prompt>#</prompt> <userinput>reboot</userinput></screen>
    </step>
  </procedure>
  <para os="debian">Numerous archive.gplhost.com mirrors are
    available around the world. All are available with both FTP and
    HTTP protocols (you should use the closest mirror). The list of
    mirrors is available at <link
    xlink:href="http://archive.gplhost.com/readme.mirrors"
    >http://archive.gplhost.com/readme.mirrors</link>.</para>
  <procedure xml:id="basics-argparse" os="debian">
    <title>Manually install python-argparse</title>
    <para>The Debian OpenStack packages are maintained on Debian Sid
      (also known as Debian Unstable) - the current development
      version. Backported packages run correctly on Debian Wheezy with
      one caveat:</para>
    <para>All OpenStack packages are written in Python. All packages
      support version 2.7; porting to Python version 3 is ongoing.
      Note that Debian Wheezy uses
      Python 2.6 and 2.7, with Python 2.7 as the default interpreter;
      Sid has only Python 2.7. There is one packaging change between
      these two. In Python 2.6, you installed the
        <package>python-argparse</package> package separately. In
      Python 2.7, this package is installed by default. Unfortunately,
      in Python 2.7, this package does not include <code>Provides:
        python-argparse</code> directive.</para>
    <step>
    <para>Because the packages are maintained in Sid where the
        <code>Provides: python-argparse</code> directive causes an
      error, and the Debian OpenStack maintainer wants to maintain one
      version of the OpenStack packages, you must manually install the
        <package>python-argparse</package> on each OpenStack system
      that runs Debian Wheezy before you install the other OpenStack
      packages. Use the following command to install the
      package:</para>
    <screen><prompt>#</prompt> <userinput>apt-get install python-argparse</userinput></screen>
    <para>This caveat applies to most OpenStack packages in
      Wheezy.</para>
    </step>
  </procedure>
  <procedure>
    <title>To finalize installation</title>
    <step>
      <para>Upgrade the packages on your system:</para>
      <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get update &amp;&amp; apt-get dist-upgrade</userinput></screen>
      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum upgrade</userinput></screen>
      <screen os="sles;opensuse"><prompt>#</prompt> <userinput>zypper refresh &amp;&amp; zypper dist-upgrade</userinput></screen>
      <note>
        <para>If the upgrade process includes a new kernel, reboot your system
          to activate it.</para>
      </note>
    </step>
    <step os="rhel;centos">
      <para>RHEL and CentOS enable <glossterm>SELinux</glossterm> by
        default. Install the <package>openstack-selinux</package> package
        to automatically manage security policies for OpenStack
        services:</para>
      <screen os="rhel;centos"><prompt>#</prompt> <userinput>yum install openstack-selinux</userinput></screen>
      <note>
        <para>Fedora does not require this package.</para>
      </note>
      <note>
        <para>The installation process for this package can take a
          while.</para>
      </note>
    </step>
  </procedure>
</section>