<?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 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="debian">This guide walks through an installation using packages available through Debian 7.0 (code name: Wheezy).</phrase> <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 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> Additionally, 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_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>