From c16f053a37a92328bf1eeffa8cfb060a370cab49 Mon Sep 17 00:00:00 2001
From: Lorin Hochstein <lorin@nimbisservices.com>
Date: Fri, 20 Apr 2012 10:27:20 -0700
Subject: [PATCH] Add command to verify credentials are working.

Also some semantic markup and minor editing.

Partially addresses bug 985019

Change-Id: Ia0e7f2dc0c33b681caacd4097b3f9061cfec8a7c
---
 .../openstack-install/configure-creds.xml     | 44 ++++++++++++++-----
 1 file changed, 33 insertions(+), 11 deletions(-)

diff --git a/doc/src/docbkx/openstack-install/configure-creds.xml b/doc/src/docbkx/openstack-install/configure-creds.xml
index 0d5bddaa9a..068ba5e25c 100644
--- a/doc/src/docbkx/openstack-install/configure-creds.xml
+++ b/doc/src/docbkx/openstack-install/configure-creds.xml
@@ -4,20 +4,42 @@
     xmlns:xi="http://www.w3.org/2001/XInclude"
     xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
     <title>Defining Compute and Image Service Credentials</title>
-    <para>Create an openrc file that can contain these variables that
-        are used by the nova (Compute) and glance (Image) command-line
-        interface clients. Make a directory to house these.</para>
+    <para>Create an <filename>openrc</filename> file that can contain these variables that
+        are used by the <command>nova</command> (Compute) and
+        <command>glance</command> (Image) command-line
+        interface clients. In this document, we store the <filename>openrc</filename>
+        file in the <filename>~/creds</filename> directory:</para>
 
-<literallayout class="monospaced">mkdir ~/creds
-sudo nano ~/creds/openrc</literallayout>
-    
-    <para>In the openrc file you create, paste these values:</para>
-<literallayout class="monospaced"><xi:include parse="text" href="samples/openrc.txt"/></literallayout>
+<screen>
+<prompt>$</prompt> <userinput>mkdir ~/creds</userinput>
+<prompt>$</prompt> <userinput>nano ~/creds/openrc</userinput>
+</screen>
+
+    <para>In the <filename>openrc</filename> file you create, paste these values:</para>
+<programlisting><xi:include parse="text" href="samples/openrc.txt"/></programlisting>
     <para>Next, ensure these are used in your environment. If you see
         401 Not Authorized errors on commands using tokens, ensure
         that you have properly sourced your credentials and that all
         the pipelines are accurate in the configuration files.</para>
-        <literallayout class="monospaced">source ~/creds/openrc</literallayout>
-    
+
+<screen>
+<prompt>$</prompt> <userinput>source ~/creds/openrc</userinput>
+</screen>
+
+<para>Verify your credentials are working by using the <command>nova</command>
+client to list the available images:</para>
+<screen>
+<prompt>$</prompt> <userinput>nova image-list</userinput>
+<computeroutput>
++--------------------------------------+-------------------+--------+--------+
+|                  ID                  |        Name       | Status | Server |
++--------------------------------------+-------------------+--------+--------+
+| 58b71381-1d8a-4cbb-94f2-c67bfced35f5 | tty-linux-kernel  | ACTIVE |        |
+| 5ca3d2fa-fd89-4edb-af41-ae96136e48ef | tty-linux-ramdisk | ACTIVE |        |
+| cc63afc1-9a83-4978-8d75-f19d874fdf94 | tty-linux         | ACTIVE |        |
++--------------------------------------+-------------------+--------+--------+
+</computeroutput>
+</screen>
+<para>Note that the ID values on your installation will be different.</para>
 </section>
-        
+