c4eaed04eb
Update version numbers for SLES 12 and openSUSE 13.2. Remove content that does not apply anymore. Adjust links for new versions. Change-Id: Ib0365f30060eabc4e02c8176422a271163d60323
173 lines
8.3 KiB
XML
173 lines
8.3 KiB
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/juno main" > /etc/apt/sources.list.d/cloudarchive-juno.list</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
<procedure os="rhel;centos;fedora">
|
|
<title>To configure prerequisites</title>
|
|
<step>
|
|
<para>Install the <package>yum-plugin-priorities</package> package to
|
|
enable assignment of relative priorities within repositories:</para>
|
|
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install yum-plugin-priorities</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>On RHEL and CentOS, enable the
|
|
<link
|
|
xlink:href="http://download.fedoraproject.org/pub/epel/7/x86_64/repoview/epel-release.html">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 the extras repository using the subscription
|
|
manager:</para>
|
|
<screen><prompt>#</prompt> <userinput>subscription-manager repos --enable=rhel-7-server-extras-rpms</userinput></screen>
|
|
<note>
|
|
<para>CentOS and Fedora do not require this repository.</para>
|
|
</note>
|
|
</step>
|
|
</procedure>
|
|
<procedure os="rhel;centos;fedora">
|
|
<title>To enable the OpenStack repository</title>
|
|
<step>
|
|
<para>Install the <package>rdo-release-juno</package> package to enable
|
|
the RDO repository:</para>
|
|
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://rdo.fedorapeople.org/openstack-juno/rdo-release-juno.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>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 <Cloud:OpenStack@build.opensuse.org>
|
|
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 && 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 && 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 && 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 && 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>
|