openstack-manuals/doc/install-guide/basic-install-files/bk-basic-install.xml
Diane Fleming 64b6c9261e Folder rename, file rename, flattening of directories
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
2013-09-08 15:15:50 -07:00

691 lines
21 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book [
<!-- Some useful entities borrowed from HTML -->
<!ENTITY ndash "&#x2013;">
<!ENTITY mdash "&#x2014;">
<!ENTITY hellip "&#x2026;">
<!ENTITY plusmn "&#xB1;">
<!-- 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>