502 lines
22 KiB
XML
502 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 12.3</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 12.3</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 has several key projects that
|
|
are separate installations but can work together
|
|
depending on your cloud needs: OpenStack Compute,
|
|
OpenStack Object Storage, OpenStack Identity Service,
|
|
and 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 17 as well as on RHEL and
|
|
derivatives through the EPEL repository.</phrase>
|
|
<phrase os="opensuse">This guide shows you
|
|
how to install OpenStack by using packages
|
|
on openSUSE 12.3 through the Open Build Service Cloud
|
|
repository.</phrase>
|
|
It offers explanations for the configuration choices
|
|
and provides sample configuration files.</para>
|
|
</abstract>
|
|
<revhistory>
|
|
<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
|
|
mulit-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_installing-openstack-overview.xml"/>
|
|
<xi:include href="ch_terminology.xml"/>
|
|
<xi:include href="ch_externals.xml"/>
|
|
<xi:include href="ch_assumptions.xml"/>
|
|
<xi:include href="ch_installidentity.xml"/>
|
|
<xi:include href="ch_installimage.xml"/>
|
|
<xi:include href="ch_installcompute.xml"/>
|
|
<xi:include href="ch_installnetworking.xml"/>
|
|
<xi:include href="ch_instances-running.xml"/>
|
|
<xi:include href="ch_installobjectstorage.xml"/>
|
|
<xi:include href="ch_installdashboard.xml"/>
|
|
<xi:include href="ap_configuration_files.xml"/>
|
|
</book>
|