openstack-manuals/doc/install-guide/bk_openstackinstallguide.xml
Tom Fifield b558315550 Add Ceilometer and Heat to install guide
This patch adds chapters for Ceilometer and Heat to the
install guide.

Change-Id: I24c861930955895a35d960a12cda2f5d5dd1e2cd
2013-10-14 12:52:45 +11:00

511 lines
22 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="opensuse"> for openSUSE</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</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>master</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
are separately installed but can work together depending on your
cloud needs: these projects include OpenStack Compute, OpenStack
Object Storage, OpenStack Block Storage, OpenStack Identity
Service, OpenStack Networking, and the OpenStack Image Service.
You can install any of these projects separately and then
configure them either as standalone or connected entities.
<phrase os="ubuntu">This guide walks through an installation
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 via 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> Additionally,
explanations of configuration options and sample configuration
files are included.</para>
</abstract>
<revhistory>
<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_keystone.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>