Edits to install guide

Closes-Bug: #1249082 Change-Id: I9f68073da5ca25867b2b8c099cce5df34f6a3eec author: diane fleming (cherry picked from commit 42b23e8)
openstack · Nov 10, 2013 · 415bcd7 · 415bcd7
1 parent 28e2610
commit 415bcd7
Show file tree

Hide file tree

Showing 53 changed files with 2,976 additions and 2,623 deletions.
diff --git a/doc/common/section_dochistory.xml b/doc/common/section_dochistory.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<section xml:id="doc_change_history" xmlns="http://docbook.org/ns/docbook"
+<section xml:id="doc_change_history"
+    xmlns="http://docbook.org/ns/docbook"
     xmlns:xi="http://www.w3.org/2001/XInclude"
     xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
     <title>Document change history</title>
@@ -9,4 +10,4 @@
         recent changes:</para>
     <?rax revhistory?>
     <!-- Table generated in output from revision element in the book element -->
-</section>
+</section>
diff --git a/doc/common/section_getstart_compute.xml b/doc/common/section_getstart_compute.xml
@@ -2,20 +2,18 @@
          xmlns:xi="http://www.w3.org/2001/XInclude"
          xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
          xml:id="compute-service">
-      <title>Compute Service</title>
-      <para>The Compute Service is a cloud computing fabric
-        controller, the main part of an IaaS system. It can be used
-        for hosting and managing cloud computing systems. The main
-        modules are implemented in Python.</para>
-      <para>
-        Compute interacts with the Identity service for authentication, Image
-        service for images, and the Dashboard service for the user and
-        administrative interface. Access to images is limited by project and
-        by user; quotas are limited per project (for example, the number of
-        instances). The Compute service is designed to scale horizontally on
-        standard hardware, and can download images to launch instances as
-        required.
-      </para>
+      <title>Compute service</title>
+      <para>The Compute service is a cloud computing fabric
+    controller, which is the main part of an IaaS system. Use it to
+    host and manage cloud computing systems. The main modules are
+    implemented in Python.</para>
+      <para>Compute interacts with the Identity Service for
+    authentication, Image Service for images, and the Dashboard for
+    the user and administrative interface. Access to images is limited
+    by project and by user; quotas are limited per project (for
+    example, the number of instances). The Compute service scales
+    horizontally on standard hardware, and downloads images to launch
+    instances as required.</para>
       <para>The Compute Service is made up of the following functional
         areas and their underlying components:</para>
       <itemizedlist>
@@ -36,8 +34,7 @@
             with <systemitem class="service">nova-network</systemitem>
             installations. For details, see
             <link xlink:href="http://docs.openstack.org/admin-guide-cloud/content/section_metadata-service.html">Metadata service</link>
-            in the <citetitle>Cloud Administrator Guide</citetitle>.
-            </para>
+            in the <citetitle>Cloud Administrator Guide</citetitle>.</para>
             <para>Note for Debian users: on Debian system, it is included in the
             <systemitem class="service">nova-api</systemitem>
             package, and can be selected through <systemitem class="library">debconf</systemitem>.</para>
@@ -142,13 +139,16 @@
             daemon. Manages x509 certificates.</para>
         </listitem>
       </itemizedlist>
-      <para os="debian">In Debian, a unique package called
-      <application>nova-consoleproxy</application> contains <application>nova-novncproxy</application>,
-      <application>nova-spicehtml5proxy</application>, and <application>nova-xvpvncproxy</application>.
-      Selection of which to use is done either by configuring
-      <filename>/etc/default/nova-consoleproxy</filename> or through
-      Debconf, or manually, by editing <filename>/etc/default/nova-consoleproxy</filename>
-      and stopping / starting the console daemons.</para>
+      <para os="debian">In Debian, a unique
+      <package>nova-consoleproxy</package> package provides the
+      <package>nova-novncproxy</package>,
+      <package>nova-spicehtml5proxy</package>, and
+      <package>nova-xvpvncproxy</package> packages. To select
+    packages, edit the
+      <filename>/etc/default/nova-consoleproxy</filename> file or use
+    the <package>debconf</package> interface. You can also manually
+    edit the <filename>/etc/default/nova-consoleproxy</filename> file
+    and stop and start the console daemons.</para>
       <itemizedlist>
         <title>Image Management (EC2 scenario)</title>
         <listitem>
@@ -207,6 +207,6 @@
       </itemizedlist>
       <para>The Compute Service interacts with other OpenStack
         services: Identity Service for authentication, Image Service
-        for images, and the OpenStack Dashboard for a web
+        for images, and the OpenStack dashboard for a web
         interface.</para>
 </section>
diff --git a/doc/common/section_getstart_image.xml b/doc/common/section_getstart_image.xml
@@ -2,7 +2,7 @@
     xmlns:xi="http://www.w3.org/2001/XInclude"
     xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
     xml:id="image-service-overview">
-      <title>Image Service Overview</title>
+      <title>Image Service overview</title>
       <para>The Image Service includes the following
         components:</para>
       <itemizedlist>
@@ -24,12 +24,11 @@
         </listitem>
         <listitem>
           <para>Storage repository for image files. In <xref
-              linkend="os-logical-arch"/>, the Object Storage Service
-            is the image repository. However, you can configure a
-            different repository. The Image Service supports normal
-            file systems, RADOS block devices, Amazon S3, and HTTP.
-            Some of these choices are limited to read-only
-            usage.</para>
+          linkend="os-logical-arch"/>, the Object Storage Service is
+        the image repository. However, you can configure a different
+        repository. The Image Service supports normal file systems,
+        RADOS block devices, Amazon S3, and HTTP. Some choices provide
+        only read-only usage.</para>
         </listitem>
       </itemizedlist>
       <para>A number of periodic processes run on the Image Service to

diff --git a/doc/common/section_getstart_metering.xml b/doc/common/section_getstart_metering.xml
@@ -2,30 +2,30 @@
     xmlns:xi="http://www.w3.org/2001/XInclude"
     xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
     xml:id="metering-service">
-      <title>Metering/Monitoring Service</title>
-      <para>The Metering Service is designed to:</para>
+      <title>The Metering service</title>
+      <para>The Metering service:</para>
       <para>
         <itemizedlist>
           <listitem>
-            <para>Efficiently collect the metering data about the CPU
-              and network costs.</para>
+            <para>Efficiently collects the metering data about the CPU
+          and network costs.</para>
           </listitem>
           <listitem>
-            <para>Collect data by monitoring notifications sent from
-              services or by polling the infrastructure.</para>
+            <para>Collects data by monitoring notifications sent from
+          services or by polling the infrastructure.</para>
           </listitem>
           <listitem>
-            <para>Configure the type of collected data to meet various
-              operating requirements. Accessing and inserting the
-              metering data through the REST API.</para>
+            <para>Configures the type of collected data to meet
+          various operating requirements. Accessing and inserting the
+          metering data through the REST API.</para>
           </listitem>
           <listitem>
-            <para>Expand the framework to collect custom usage data by
-              additional plug-ins.</para>
+            <para>Expands the framework to collect custom usage data
+          by additional plug-ins.</para>
           </listitem>
           <listitem>
-            <para>Produce signed metering messages that cannot be
-              repudiated.</para>
+            <para>Produces signed metering messages that cannot be
+          repudiated.</para>
           </listitem>
         </itemizedlist>
       </para>