64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
691 lines
21 KiB
XML
691 lines
21 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE book [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
<!ENTITY plusmn "±">
|
|
<!-- Useful for describing APIs -->
|
|
<!ENTITY GET '<command xmlns="http://docbook.org/ns/docbook">GET</command>'>
|
|
<!ENTITY PUT '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'>
|
|
<!ENTITY POST '<command xmlns="http://docbook.org/ns/docbook">POST</command>'>
|
|
<!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'>
|
|
]>
|
|
<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-basic-install-grizzly">
|
|
<title>OpenStack Basic Installation Guide<phrase
|
|
os="rhel;centos;fedora"> for Fedora 18</phrase>
|
|
<phrase os="ubuntu;debian"> for Ubuntu 12.04 (LTS) and Debian
|
|
Wheezy</phrase>
|
|
<phrase os="opensuse"> for openSUSE 12.3</phrase></title>
|
|
<?rax subtitle.font.size="18px" title.font.size="24px"?>
|
|
<titleabbrev>OpenStack Install Guide<phrase os="rhel;centos;fedora">
|
|
for Fedora 18</phrase>
|
|
<phrase os="ubuntu;debian"> for Ubuntu 12.04 (LTS) and Debian
|
|
Wheezy</phrase>
|
|
<phrase os="opensuse">for openSUSE 12.3</phrase></titleabbrev>
|
|
<info>
|
|
<author>
|
|
<personname>
|
|
<firstname/>
|
|
<surname/>
|
|
</personname>
|
|
<affiliation>
|
|
<orgname>OpenStack Foundation</orgname>
|
|
</affiliation>
|
|
</author>
|
|
<copyright>
|
|
<year>2009</year>
|
|
<year>2010</year>
|
|
<year>2011</year>
|
|
<year>2012</year>
|
|
<year>2013</year>
|
|
<holder>OpenStack Foundation</holder>
|
|
</copyright>
|
|
<releaseinfo>master</releaseinfo>
|
|
<productname>OpenStack Basic Installation Guide</productname>
|
|
<pubdate/>
|
|
<legalnotice role="apache2">
|
|
<annotation>
|
|
<remark>Copyright details are filled in by the
|
|
template.</remark>
|
|
</annotation>
|
|
</legalnotice>
|
|
<abstract>
|
|
<para>This document is for administrators who install OpenStack
|
|
on various Linux distributions.</para>
|
|
</abstract>
|
|
<revhistory>
|
|
<revision>
|
|
<date>2013-08-23</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Add information for Debian Wheezy.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Editorial changes.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-08-13</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Add information about openSUSE 12.3.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-07-24</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added libvirt_vif_driver setting required for
|
|
functional OVS networking setup (Bug #
|
|
1199853).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-07-18</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated to make sure than sysctl settings are
|
|
applied.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Updated <xref
|
|
linkend="basic-install_controller-glance"/> to
|
|
configure the glance auth strategy.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Noted in <xref linkend="network-ovs"/> that
|
|
iptables rules are lost on reboot.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Added missing prompts.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Updated to use more consistent spacing.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Added the <literal>my_ip</literal> parameter in
|
|
<filename>nova.conf</filename> samples (in <xref
|
|
linkend="basic-install_controller-nova"/> and in
|
|
<xref linkend="basic-install_compute-nova"
|
|
/>).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Updated <xref
|
|
linkend="basic-install_controller-dashboard"/> to
|
|
use the controller IP address to access horizon</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-07-15</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated revision history (Bug # 1198743).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-07-12</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Removed references to uec images as they are not
|
|
used in the guide.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Updated to refer to "CirrOS" images rather than
|
|
"Cirros" images, for consistency.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Added missing prompt characters.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Updated to hide the
|
|
<systemitem>neutron-ovs-cleanup</systemitem> step in
|
|
network setup from readers of the Ubuntu/Debian
|
|
version of the guide.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-07-09</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated <filename>api-paste</filename>
|
|
configuration to use
|
|
<package>python-keystoneclient</package> instead of
|
|
<package>keystone</package>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-06-26</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Changed neutron config sections to lower case (Bug
|
|
# 1192140).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-06-14</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>More updates to the User Guide, including changes
|
|
to common files.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-06-13</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Removed link in diagram
|
|
http://docs.openstack.org/grizzly/basic-install/apt/content/basic-install_architecture.html
|
|
(Bug # 1187769).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-06-04</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Cleaned up common dashboard install files for
|
|
future sharing with new user guide.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-29</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Remove version from Glance endpoint.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-21</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Corrected mistake when connecting to the newly
|
|
created virtual machine.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-23</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Remove -y option from package install
|
|
commands.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Fix language issues.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-22</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Fix typographical errors in Fedora
|
|
description.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-21</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added <systemitem class="service"
|
|
>nova-conductor</systemitem> into restart
|
|
section</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-09</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added support for separate Disqus threads for the
|
|
two versions of the guide.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-08</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated Install Guide titles for
|
|
consistency</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Eliminate more ttylinux references.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-02</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Fixes for Ubuntu network setup.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-03</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Ensure <systemitem>qpid</systemitem> and
|
|
<systemitem>rabbitmq</systemitem> are correctly
|
|
conditionalized for 2 outputs.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-02</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated to add a cover and include minor
|
|
typographical edits.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-05-01</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Keystone authentication in cinder.conf instead of
|
|
paste-api.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Fix software repository links for
|
|
Fedora/RHEL/Centos.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-27</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Rewrote guide for Grizzly</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-15</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added command to generate keystone SSL keys for
|
|
PKI.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-24</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated network connectivity diagrams.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-12</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Initial version with conditions for Fedora, RHEL,
|
|
and CentOS.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-09</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Renamed <literal>root_helper</literal>
|
|
configuration section to
|
|
<literal>rootwrap_config</literal>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-08</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added information about packages for Ubuntu and
|
|
Debian.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-06</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added instructions to move IP address to bridge
|
|
interface for networking setup (Bug # 1098311).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-04-05</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added <systemitem class="service"
|
|
>nova-conductor</systemitem> to the controller node
|
|
in installation (Bug # 1165020).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-03-29</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Grizzly release preparation - old releases and
|
|
bugs deleted.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-03-27</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Fixed minor typographical issue.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-03-20</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added clarifying statement for missing server
|
|
installation on Red Hat based systems.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-02-21</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Removed redundant TGT section from controller node
|
|
configuration.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-02-18</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Remove SimpleScheduler from documentation.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-02-13</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Reverted to standard hosts file.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-31</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added hosts file example. Dropped the folsom-
|
|
prefix from the hostnames (Bug # 1091827).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Moved gateway to correct interface extracting
|
|
<literal>7.7.7.1</literal> from network node
|
|
configuration (Bug # 1111967).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-30</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added <systemitem>glance-registry</systemitem>
|
|
into controller.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-29</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Deleted <systemitem>nova-api-metadata</systemitem>
|
|
on Compute node.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-25</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Fixed noVNC Configuration.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-22</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added <parameter>auth_host</parameter> to
|
|
<filename>api-paste.ini</filename> (Bug #
|
|
1091883).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-14</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Fixed DATA IP on network node.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-13</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Fixed <parameter>local_ip</parameter> in
|
|
<filename>ovs_neutron_plugin.ini</filename> file on
|
|
compute node</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Added missing <filename>novarc</filename> on
|
|
Network node.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2013-01-08</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Configure <parameter>connection_type</parameter>
|
|
in <filename>nova.conf</filename> on Compute
|
|
Node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Configure <filename>api-paste.ini</filename> for
|
|
OpenStack Networking on Network node.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-12-25</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Updated networking installation
|
|
instructions.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-12-23</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added missing <package>linux-headers-*</package>
|
|
package to installation command for Cinder (Bug #
|
|
1092424).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-12-19</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added <literal>-y</literal> parameter to force
|
|
installation when using <command>apt-get</command>
|
|
(Bug # 1091988).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-12-18</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added missing continuation character when
|
|
installing networking packages (Bug # 1091859).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Bug fixes for Basic Install reported in
|
|
comments</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2012-12-15</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Added Network node and improved networking
|
|
instructions.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
<revision>
|
|
<date>2009-01-01</date>
|
|
<revdescription>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>First edition of this guide.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</revdescription>
|
|
</revision>
|
|
</revhistory>
|
|
</info>
|
|
<xi:include href="basic-install_intro.xml"/>
|
|
<xi:include href="basic-install_architecture.xml"/>
|
|
<xi:include href="basic-install_installation.xml"/>
|
|
<xi:include href="basic-install_operate.xml"/>
|
|
<xi:include href="basic-install_conclusion.xml"/>
|
|
</book>
|