openstack/openstack-manuals
Code Issues Proposed changes

Update install guide for folsom:

Browse Source 
- Point to cloud archive for ubuntu packages
- Add Folsom to release table
- Adds ch_installingfolsom.xml but doesn't xi:include it in book
file yet.

Patchset removes ch_installingfolsom.xml as I've patched the
other patch to make it an appendix.

Rebase against master.

Change-Id: I0b1d8ffa8f62e6c5b38e6ee0df7ee2e2dd456ddb
This commit is contained in:
annegentle 2012-09-27 09:48:51 -05:00
parent 5f55b3ae46
commit 842dd948d7
8 changed files with 83 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/src/docbkx/common/kvm.xml
View File

@ -40,9 +40,11 @@ libvirt_type=kvm</programlisting>
<listitem>
<para><link
xlink:href="http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Virtualization_Host_Configuration_and_Guest_Installation_Guide/sect-Virtualization_Host_Configuration_and_Guest_Installation_Guide-Host_Installation-Installing_KVM_packages_on_an_existing_Red_Hat_Enterprise_Linux_system.html"
>RHEL: Installing virtualization packages on an existing Red Hat Enterprise
Linux system</link> from the Red Hat Enterprise Linux Virtualizaiton Host
Configuration and Guest Installation Guide.</para>
>RHEL: Installing virtualization packages on
an existing Red Hat Enterprise Linux
system</link> from the Red Hat Enterprise
Linux Virtualization Host Configuration and Guest
Installation Guide.</para>
</listitem>
<listitem>
<para><link
@ -53,8 +55,9 @@ libvirt_type=kvm</programlisting>
<listitem>
<para><link
xlink:href="http://doc.opensuse.org/products/draft/SLES/SLES-kvm_sd_draft/cha.kvm.requires.html#sec.kvm.requires.install"
>SLES: Installing KVM</link> from the SUSE Linux Enterprise
ServerVirtualization with KVM manual.</para>
>SLES: Installing KVM</link> from the SUSE
Linux Enterprise Server Virtualization with KVM
manual.</para>
</listitem>
</itemizedlist></para>
<section xml:id="checking-kvm">

25
doc/src/docbkx/common/qemu.xml
View File

@ -12,14 +12,16 @@
performance than KVM and is a poor choice for a production deployment.</para>
<para>The typical uses cases for QEMU are<itemizedlist>
<listitem>
<para>Running on older hardware that lacks virtualization support.</para>
<para>Running on older hardware that lacks
virtualization support.</para>
</listitem>
<listitem>
<para>Running the Compute service inside of a virtual machine for development or
testing purposes, where the hypervisor does not support native virtualization
for guests.</para>
<para>Running the Compute service inside of a virtual
machine for development or testing purposes, where
the hypervisor does not support native
virtualization for guests.</para>
</listitem>
</itemizedlist>running on</para>
</itemizedlist></para>
<para>KVM requires hardware support for acceleration. If hardware support is not available
(e.g., if you are running Compute inside of a VM and the hypervisor does not expose the
required hardware support), you can use QEMU instead. KVM and QEMU have the same level of
@ -47,9 +49,16 @@ libvirt_type=qemu</programlisting></para>
</listitem>
</itemizedlist>
<section xml:id="fixes-rhel-qemu" os="rhel;fedora;centos"><title>Tips and fixes for QEMU on RHEL</title>
<para>
If you are testing OpenStack in a virtual machine, you need to configure nova to use qemu without KVM and hardware virtualization. The second command relaxes SELinux rules to allow this mode of operation (https://bugzilla.redhat.com/show_bug.cgi?id=753589) The last 2 commands here work around a libvirt issue fixed in RHEL 6.4. Note nested virtualization will be the much slower TCG variety, and you should provide lots of memory to the top level guest, as the openstack created guests default to 2GM RAM with no overcommit.
</para>
<para> If you are testing OpenStack in a virtual machine, you need
to configure nova to use qemu without KVM and hardware
virtualization. The second command relaxes SELinux rules
to allow this mode of operation
(https://bugzilla.redhat.com/show_bug.cgi?id=753589) The
last 2 commands here work around a libvirt issue fixed in
RHEL 6.4. Note nested virtualization will be the much
slower TCG variety, and you should provide lots of memory
to the top level guest, as the OpenStack-created guests
default to 2GM RAM with no overcommit. </para>
<note><para>The second command, <command>setsebool</command>, may take a while.</para></note>
<screen><prompt>$></prompt> <userinput>sudo openstack-config --set /etc/nova/nova.conf DEFAULT libvirt_type qemu</userinput>
<prompt>$></prompt> <userinput>setsebool -P virt_use_execmem on</userinput>

12
doc/src/docbkx/openstack-install/bk_openstackinstallguide.xml
View File

@ -26,7 +26,7 @@
</copyright>
<releaseinfo>trunk</releaseinfo>
<productname>OpenStack</productname>
<pubdate>2012-07-23</pubdate>
<pubdate>2012-09-26</pubdate>
<legalnotice role="apache2">
<annotation>
<remark>Copyright details are filled in by the template.</remark>
@ -51,6 +51,16 @@
as well as sample configuration files. </para>
</abstract>
<revhistory>
<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>

10
doc/src/docbkx/openstack-install/ch_assumptions.xml
View File

@ -58,8 +58,14 @@
<para>FlatDHCP with a single network interface.</para>
</listitem>
<listitem>
<para>KVM or Xen (XenServer or XCP) as the hypervisor.</para>
</listitem>
<para>KVM or Xen (XenServer or XCP) as the
hypervisor.</para>
</listitem>
<listitem>
<para os="ubuntu">On Ubuntu, enable the Cloud Archive repository by
adding the following to
/etc/apt/sources.list.d/folsom.list:<screen>deb http://ubuntu-cloud.archive.canonical.com/ubuntu precise-updates/folsom main</screen></para>
</listitem>
<listitem>
<para os="rhel;fedora;centos">Ensure the operating system is up-to-date by
running <command>yum update</command> prior to

8
doc/src/docbkx/openstack-install/ch_externals.xml
View File

@ -107,9 +107,11 @@
via iSCSI using <emphasis role="italic">IET</emphasis> or <emphasis role="italic"
>tgt</emphasis>. It can also be configured to use other iSCSI-based storage
technologies.</para>
<para>In a future OpenStack release, functionality that is currently implemented by
<systemitem class="service">nova-volume</systemitem> will be available through a
separate OpenStack project, codenamed Cinder.</para></simplesect>
<para>In the Folsom OpenStack release, functionality available
through <systemitem class="service"
>nova-volume</systemitem> is also available through a
separate OpenStack Volumes project, code-named
Cinder.</para></simplesect>
<simplesect>
<title>openstack-dashboard</title>
<para>The <systemitem class="service">openstack-dashboard</systemitem> is a Django-based

27
doc/src/docbkx/openstack-install/ch_terminology.xml
View File

@ -28,6 +28,12 @@
</tr>
</thead>
<tbody>
<tr>
<td><link xlink:href="http://wiki.openstack.org/ReleaseNotes/Folsom">Folsom</link></td>
<td>September 2012</td>
<td>2012.2</td>
<td>1.7.2</td>
</tr>
<tr>
<td><link xlink:href="http://wiki.openstack.org/ReleaseNotes/Essex">Essex</link></td>
<td>April 2012</td>
@ -123,6 +129,22 @@
<para>Swift</para>
</td>
</tr>
<tr>
<td>
<para>Volumes</para>
</td>
<td>
<para>Cinder</para>
</td>
</tr>
<tr>
<td>
<para>Networking</para>
</td>
<td>
<para>Quantum</para>
</td>
</tr>
</tbody>
</table>
</para>
@ -190,8 +212,9 @@
</section>
<section xml:id="terminology-block-storage">
<title>Block storage (SAN)</title>
<para>In OpenStack: Volumes (<systemitem class="service">nova-volume</systemitem>
service) in OpenStack Compute</para>
<para>In OpenStack: Volumes (<systemitem class="service"
>nova-volume</systemitem> service) in OpenStack
Compute or cinder as a separate Volume service</para>
<para>Related concepts: Amazon Elastic Block Store (EBS),
Ceph RADOS Block Device (RBD), iSCSI</para>
<para>With <emphasis role="italic">block storage</emphasis>, files are exposed through a

6
doc/src/docbkx/openstack-install/compute-config-guest-network.xml
View File

@ -11,8 +11,8 @@
<para>Set your network interface in promiscuous mode so that it can receive packets that are
intended for virtual machines. As
root:<screen><prompt>#</prompt> <userinput>ip link set eth0 promisc on</userinput></screen></para>
<para>Set up your /etc/network/interfaces file with these settings: </para>
<itemizedlist><listitem><para>eth0: public IP, gateway</para></listitem>
<para os="ubuntu">Set up your /etc/network/interfaces file with these settings: </para>
<itemizedlist os="ubuntu"><listitem><para>eth0: public IP, gateway</para></listitem>
<listitem><para>br100: no ports, stp off, fd 0, first address from fixed_range set in nova.conf files.</para></listitem></itemizedlist>
<para os="ubuntu">Here's an Ubuntu/Debian example:</para>
<para os="ubuntu"><literallayout class="monospaced"># The loopback network interface
@ -30,7 +30,7 @@ address 192.168.100.1
netmask 255.255.255.0
bridge_stp off
bridge_fd 0</literallayout></para>
<para os="centos;fedora;rhel">Here's an example for RHEL, Fedora, or CentOS. Create
<para os="centos;fedora;rhel">Here's an example network setup for RHEL, Fedora, or CentOS. Create
<filename>/etc/sysconfig/network-scripts/ifcfg-br100</filename>:</para>
<literallayout os="centos;fedora;rhel" class="monospaced">

11
doc/src/docbkx/openstack-install/install-config-proxy-node.xml
View File

@ -4,10 +4,11 @@
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" >
<title>Installing and Configuring the Proxy Node</title>
<para>The proxy server takes each request and looks up locations for the
account, container, or object and routes the requests correctly. The
proxy server also handles API requests. You enable account
management by configuring it in the proxy-server.conf file. </para>
<para>The proxy server takes each request and looks up locations
for the account, container, or object and routes the requests
correctly. The proxy server also handles API requests. You
enable account management by configuring it in the
<filename>proxy-server.conf</filename> file. </para>
<note>
<para>It is assumed that all commands are run as the root user.</para>
</note>
@ -41,7 +42,7 @@ to
<screen><prompt>#</prompt><userinput>service memcached restart</userinput></screen></para>
</listitem>
<listitem os="rhel;centos;fedora">
<para>To set up Object Storage to authenticate tokens we need to set the keystone Admin
<para>RHEL/CentOS/Fedora Only: To set up Object Storage to authenticate tokens we need to set the keystone Admin
token in the swift proxy file with the openstack-config command.
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/swift/proxy-server.conf filter:authtoken admin_token $ADMIN_TOKEN</userinput>
<prompt>#</prompt> sudo <userinput>openstack-config --set /etc/swift/proxy-server.conf filter:authtoken auth_token $ADMIN_TOKEN</userinput></screen>