bcf5a7cb3a
This adds a small glossary to the Install Guide. The glossary is produced from all entries that use <firstterm> or <glossterm> and which are in the global glossary (see file glossary/gloss-terms.xml). I (dcramer) have patched this to work if built against https://review.openstack.org/68416, which fixes the problem where the glossary wasn't populated in the pdf. Updates to clouddocs-maven-plugin 1.13.0 that has dcramer's fix. Change-Id: I357265ea99a7e9b0f4004ef529a2043605e8b2ec
574 lines
24 KiB
XML
574 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="app_reserved_uids.xml"/>
|
|
<xi:include href="../common/app_support.xml"/>
|
|
|
|
<glossary role="auto"/>
|
|
</book>
|