ed8fd1c397
This new chapter is taken from the common/ section, and explains how to install clients on machines outside the OpenStack cluster. The install guide can be misleading about how to use clients to administrate the cloud, adding this section will hopefully help clarifying this. pom.xml is modified to add an audience target (installer), used to build specific parts of the common files. backport: none Change-Id: Ib4187d86bb2e3d7d9a26df426e17b4f4039a90fa
571 lines
24 KiB
XML
571 lines
24 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<book xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:svg="http://www.w3.org/2000/svg"
|
|
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0"
|
|
xml:id="openstack-install-manual-grizzly">
|
|
<title>OpenStack Installation Guide<phrase os="rhel;centos;fedora"
|
|
> for Red Hat Enterprise Linux, CentOS, and
|
|
Fedora</phrase>
|
|
<phrase os="ubuntu"> for Ubuntu 12.04 (LTS)</phrase>
|
|
<phrase os="debian"> for Debian 7.0 (Wheezy)</phrase>
|
|
<phrase os="opensuse"> for openSUSE and SUSE Linux Enterprise
|
|
Server</phrase>
|
|
</title>
|
|
<?rax subtitle.font.size="17px" title.font.size="32px"?>
|
|
<titleabbrev>OpenStack Installation Guide<phrase
|
|
os="rhel;centos;fedora"> for Red Hat Enterprise Linux,
|
|
CentOS, and Fedora</phrase>
|
|
<phrase os="ubuntu"> for Ubuntu 12.04 (LTS)</phrase>
|
|
<phrase os="opensuse"> for openSUSE and SUSE Linux Enterprise
|
|
Server</phrase>
|
|
<phrase os="debian"> for Debian 7.0 (Wheezy)</phrase>
|
|
</titleabbrev>
|
|
<info>
|
|
<author>
|
|
<personname>
|
|
<firstname/>
|
|
<surname/>
|
|
</personname>
|
|
<affiliation>
|
|
<orgname>OpenStack</orgname>
|
|
</affiliation>
|
|
</author>
|
|
<copyright>
|
|
<year>2012</year>
|
|
<year>2013</year>
|
|
<holder>OpenStack Foundation</holder>
|
|
</copyright>
|
|
<releaseinfo>havana</releaseinfo>
|
|
<productname>OpenStack Installation Guide</productname>
|
|
<pubdate/>
|
|
<legalnotice role="apache2">
|
|
<annotation>
|
|
<remark>Copyright details are filled in by the
|
|
template.</remark>
|
|
</annotation>
|
|
</legalnotice>
|
|
<abstract>
|
|
<para>The OpenStack® system consists of several key
|
|
projects that you install separately but that work
|
|
together depending on your cloud needs. These projects
|
|
include Compute, Identity Service, Networking, Image
|
|
Service, Block Storage Service, Object Storage,
|
|
Telemetry, and Orchestration. You can install any of
|
|
these projects separately and configure them
|
|
standalone or as connected entities. <phrase
|
|
os="debian">This guide walks through an
|
|
installation by using packages available through
|
|
Debian 7.0 (code name: Wheezy).</phrase>
|
|
<phrase os="ubuntu">This guide walks through an
|
|
installation by using packages available through
|
|
Ubuntu 12.04 (LTS).</phrase>
|
|
<phrase os="rhel;centos;fedora">This guide shows you
|
|
how to install OpenStack by using packages
|
|
available through Fedora 19 as well as on Red Hat
|
|
Enterprise Linux and its derivatives through the
|
|
EPEL repository.</phrase>
|
|
<phrase os="opensuse">This guide shows you how to
|
|
install OpenStack by using packages on openSUSE
|
|
through the Open Build Service Cloud
|
|
repository.</phrase> Explanations of configuration
|
|
options and sample configuration files are
|
|
included.</para>
|
|
</abstract>
|
|
<revhistory>
|
|
<revision>
|
|
<date>2013-10-25</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Added initial Debian support.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-10-17</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Havana release.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-10-16</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Add support for SUSE Linux
|
|
Enterprise.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-10-08</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Complete reorganization for
|
|
Havana.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-09-09</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Build also for openSUSE.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-08-01</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Fixes to Object Storage verification
|
|
steps. Fix bug <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1207347"
|
|
>1207347</link>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-07-25</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Adds creation of cinder user and
|
|
addition to the service tenant. Fix
|
|
bug <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1205057"
|
|
>1205057</link>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-08</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updated the book title for
|
|
consistency.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-02</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updated cover and fixed small errors
|
|
in appendix.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-30</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Grizzly release.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-18</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updates and clean up on the Object
|
|
Storage installation.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-08</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Adds a note about availability of
|
|
Grizzly packages on Ubuntu and
|
|
Debian.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-03</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updates RHEL/CentOS/Fedora
|
|
information for Grizzly
|
|
release.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-03-26</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updates Dashboard (Horizon)
|
|
information for Grizzly
|
|
release.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-02-12</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Adds chapter about Essex to Folsom
|
|
upgrade for Compute and related
|
|
services (excludes OpenStack Object
|
|
Storage (Swift) and OpenStack
|
|
Networking (Quantum)).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-16</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Fix file copy issue for figures in
|
|
the /common/ directory.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-11-09</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Folsom release of this
|
|
document.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-10-10</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1054459"
|
|
>1054459</link><link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1064745"
|
|
>1064745</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-09-26</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Adds an all-in-one install
|
|
section.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-07-23</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Adds additional detail about
|
|
installing and configuring
|
|
nova-volumes.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/978510"
|
|
>978510</link>
|
|
<link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1027230"
|
|
>1027230</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-07-17</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Update build process so two
|
|
uniquely-named PDF files are
|
|
output.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-07-13</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1025840"
|
|
>1025840</link>
|
|
<link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1025847"
|
|
>1025847</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-06-19</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Fix PDF links.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/967778"
|
|
>967778</link>
|
|
<link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/984959"
|
|
>984959</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1002294"
|
|
>1002294</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1010163"
|
|
>1010163</link>.</para>
|
|
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-05-31</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Revise install guide to encompass
|
|
more Linux distros.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/996988"
|
|
>996988</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/998116"
|
|
>998116</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/999005"
|
|
>999005</link>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-05-03</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Fixes problems with
|
|
<filename>glance-api-paste.ini</filename>
|
|
and
|
|
<filename>glance-registry-paste.ini</filename>
|
|
samples and instructions.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Removes "DRAFT" designation.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-05-02</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Essex release.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-05-01</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updates the Object Storage and
|
|
Identity (Keystone)
|
|
configuration.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-04-25</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Changes service_id copy/paste error
|
|
for the EC2 service-create
|
|
command.</para>
|
|
<para>Adds verification steps for Object
|
|
Storage installation.</para>
|
|
<para>Fixes
|
|
<filename>proxy-server.conf</filename>
|
|
file so it points to keystone not
|
|
tempauth.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-04-23</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Adds installation and configuration
|
|
for multi-node Object Storage
|
|
service.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-04-17</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/983417"
|
|
>983417</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/984106"
|
|
>984106</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/984034"
|
|
>984034</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-04-13</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/977905"
|
|
>977905</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/980882"
|
|
>980882</link>, <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/977823"
|
|
>977823</link>, adds additional
|
|
Glance database preparation
|
|
steps</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-04-10</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Doc bug fixes: <link
|
|
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/977831"
|
|
>977831</link></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-03-23</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updates for Xen hypervisor.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-03-09</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Updates for Essex release, includes
|
|
new Glance config files, new Keystone
|
|
configuration.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-01-24</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Initial draft for Essex.</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Assumes use of Ubuntu 12.04
|
|
repository.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2011-01-24</date>
|
|
<revdescription>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Initial draft for Diablo.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
</revhistory>
|
|
</info>
|
|
|
|
<!-- Chapters are referred from the book file through these
|
|
include statements. You can add additional chapters using
|
|
these types of statements. -->
|
|
<xi:include href="ch_preface.xml"/>
|
|
<xi:include href="ch_overview.xml"/>
|
|
<xi:include href="ch_basics.xml"/>
|
|
<xi:include href="ch_debconf.xml"/>
|
|
<xi:include href="ch_keystone.xml"/>
|
|
<xi:include href="ch_clients.xml"/>
|
|
<xi:include href="ch_glance.xml"/>
|
|
<xi:include href="ch_nova.xml"/>
|
|
<xi:include href="ch_horizon.xml"/>
|
|
<xi:include href="ch_cinder.xml"/>
|
|
<xi:include href="ch_swift.xml"/>
|
|
<xi:include href="ch_neutron.xml"/>
|
|
<xi:include href="ch_heat.xml"/>
|
|
<xi:include href="ch_ceilometer.xml"/>
|
|
<xi:include href="../common/app_support.xml"/>
|
|
</book>
|