openstack/openstack-manuals
Code Issues Proposed changes

Merge "Minor OS-specific edit fixups."

Browse Source
This commit is contained in:
Jenkins
2012-06-14 21:30:34 +00:00
committed by Gerrit Code Review
parent 050594a4be 1945231968
commit 4ba10518fe
4 changed files with 52 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -39,9 +39,18 @@
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. This guide
either as standalone or connected entities.
<phrase os="ubuntu">This guide
walks through an installation using packages available
through Ubuntu 12.04. It offers explanations for the
through Ubuntu 12.04.</phrase>
<phrase os="rhel;centos;fedora">This guide
walks through an installation using packages available
through Fedora 17 as well as on RHEL and derivatives through
the EPEL repository.</phrase>
It offers explanations for the
configuration choices as well as sample configuration
files. </para>
</abstract>

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

@@ -8,11 +8,16 @@
options. To simplify this installation guide, we make
a number of assumptions about the target installation.</para>
<itemizedlist>
<listitem><para>You have a collection of compute nodes, each installed with a
supported Linux distribution: Fedora 17, Ubuntu
Server 12.04, RHEL 6.2, Scientific Linux 6.1 or
<listitem>
<para os="rhel;centos;fedora">You have a collection of compute
nodes, each installed with Fedora 17, RHEL 6.2, Scientific Linux 6.1 or
CentOS 6 + CR distributions (continuous release ( CR ) repository).</para>
<note><para>Debian, openSUSE, and SLES also have OpenStack support, but are not documented here.</para></note></listitem>
<para os="ubuntu">You have a collection of compute nodes, each installed with Ubuntu
Server 12.04.</para>
<note><para>
<phrase os="rhel;centos;fedora">There is also an <link xlink:href="http://docs.openstack.org/essex/openstack-compute/install/apt/content/">OpenStack Install and Deploy Manual for Ubuntu</link></phrase>
<phrase os="ubuntu">There is also an <link xlink:href="http://docs.openstack.org/essex/openstack-compute/install/yum/content/">OpenStack Install and Deploy Manual for RHEL, CentOS and Fedora</link></phrase> Debian, openSUSE, and SLES also have OpenStack support, but are not documented here.</para></note></listitem>
<listitem><para>You have designated one of the nodes as the Cloud Controller,
which will run all of the services (RabbitMQ or
Qpid, MySQL, Identity, Image, nova-api,
@@ -33,8 +38,11 @@
<listitem>
<para>Ensure that the server can resolve its own hostname,
otherwise you may have problems if you are using RabbitMQ
as the messaging backend (RabbitMQ is the default messaging
back-end on Ubuntu, on Fedora the default backend is Qpid).</para>
as the messaging backend.
<phrase os="ubuntu">RabbitMQ is the default messaging
back-end on Ubuntu</phrase>
<phrase os="rhel;centos;fedora">Qpid is the default messaging
back-end on Fedora</phrase></para>
</listitem>
<listitem>
<para><literal>192.168.206.130</literal> is the primary IP for our host
@@ -51,9 +59,11 @@
<para>KVM or Xen (XenServer or XCP) as the hypervisor.</para>
</listitem>
<listitem>
<para>Ensure the operating system is up-to-date by
running <command>yum update</command> or
<command>apt-get update</command> and
<para os="rhel;fedora;centos">Ensure the operating system is up-to-date by
running <command>yum update</command> prior to
the installation.</para>
<para os="ubuntu">>Ensure the operating system is up-to-date by
running <command>apt-get update</command> and
<command>apt-get upgrade</command> prior to
the installation.</para>
</listitem>

31
doc/src/docbkx/openstack-install/compute-verifying-install.xml
View File

@@ -4,19 +4,26 @@
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
<title>Verifying the Compute Installation</title>
<para>You can ensure all the Compute services are running by using the nova-manage command:</para>
<literallayout class="monospaced">sudo nova-manage service list</literallayout>
<para>You can ensure all the Compute services are running by using the
<command>nova-manage</command> command, as root:</para>
<screen><prompt>#</prompt> <userinput>nova-manage service list</userinput></screen>
<para>In return you should see "smiley faces" rather than three X symbols. Here's an example.</para>
<literallayout class="monospaced">Binary Host Zone Status State Updated_At
nova-compute ubuntu nova enabled :-) 2012-04-02 14:06:15
nova-cert ubuntu nova enabled :-) 2012-04-02 14:06:16
nova-volume ubuntu nova enabled :-) 2012-04-02 14:06:14
nova-scheduler ubuntu nova enabled :-) 2012-04-02 14:06:11
nova-network ubuntu nova enabled :-) 2012-04-02 14:06:13
nova-consoleauth ubuntu nova enabled :-) 2012-04-02 14:06:10</literallayout>
<para>You can find the version of the installation by using the nova-manage
command:</para>
<literallayout class="monospaced">sudo nova-manage version list</literallayout>
<screen><computeroutput>Binary Host Zone Status State Updated_At
nova-compute myhost nova enabled :-) 2012-04-02 14:06:15
nova-cert myhost nova enabled :-) 2012-04-02 14:06:16
nova-volume myhost nova enabled :-) 2012-04-02 14:06:14
nova-scheduler myhost nova enabled :-) 2012-04-02 14:06:11
nova-network myhost nova enabled :-) 2012-04-02 14:06:13
nova-consoleauth myhost nova enabled :-) 2012-04-02 14:06:10</computeroutput></screen>
<para><note>
<para>If you see three X symbols and are running services
on separate hosts, ensure that ntp is synchronizing
time correctly and that all servers match their time.
Out-of-sync time stamps are the most common cause of
the XXX state.</para>
</note>You can find the version of the installation by using
the <command>nova-manage</command> command, as root:</para>
<screen><prompt>#</prompt> <userinput>nova-manage version list</userinput></screen>
<para>The version number 2012.1 corresponds with the Essex
release of Compute.</para>

6
doc/src/docbkx/openstack-install/identity-verify-install.xml
View File

@@ -73,8 +73,8 @@
<screen>
<prompt>$</prompt> <userinput>. ./keystonerc</userinput></screen>
<para>You should see a listing of users after typing in <userinput>keystone user-list</userinput>.</para>
<screen>$&gt; keystone user-list
nova@ubuntu:~$ keystone user-list
<screen><prompt>$</prompt> <userinput>keystone user-list</userinput>
<computeroutput>
+----------------------------------+---------+-------+-----------+
| id | enabled | email | name |
+----------------------------------+---------+-------+-----------+
@@ -84,5 +84,5 @@ nova@ubuntu:~$ keystone user-list
| ca951c79453d4033a7c270bc6e0860fa | True | None | adminUser |
| ec47114af7014afd9a8994cbb6057a8b | True | None | ec2 |
+----------------------------------+---------+-------+-----------+
</screen>
</computeroutput></screen>
</section>