From 698fd05cdc2d871fd494af01d3ab5f93bd401e4c Mon Sep 17 00:00:00 2001
From: andydugas <adugas@vmware.com>
Date: Thu, 3 Apr 2014 17:30:40 -0700
Subject: [PATCH] Added ISO image support documentation

Created a new file for procedures and modified the chapter level
file to include the new file.

Change-Id: I101dec7d60671561a92fe4a709a55da9e8517dc2
Closes-Bug: #1302260
---
 doc/config-reference/ch_imageservice.xml      |  1 +
 .../section_image-service-ISO-support.xml     | 44 +++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 doc/config-reference/image-service/section_image-service-ISO-support.xml

diff --git a/doc/config-reference/ch_imageservice.xml b/doc/config-reference/ch_imageservice.xml
index a49ecce259..3e410d4456 100644
--- a/doc/config-reference/ch_imageservice.xml
+++ b/doc/config-reference/ch_imageservice.xml
@@ -44,6 +44,7 @@
     <xi:include href="../common/tables/glance-testing.xml"/>
     <xi:include href="../common/tables/glance-wsgi.xml"/>
     <xi:include href="../common/tables/glance-zmq.xml"/>
+   <xi:include href="image-service/section_image-service-ISO-support.xml"/>
    <xi:include href="image-service/section_image-service-backends.xml"/>
   <xi:include href="image-service/section_image-service-sample-configuration-files.xml" />
 </chapter>
diff --git a/doc/config-reference/image-service/section_image-service-ISO-support.xml b/doc/config-reference/image-service/section_image-service-ISO-support.xml
new file mode 100644
index 0000000000..ba0281553f
--- /dev/null
+++ b/doc/config-reference/image-service/section_image-service-ISO-support.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section xml:id="iso-support" 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>Support for ISO images</title>
+    <para>You can load ISO images into the Image Service. You can
+        subsequently boot an ISO image using Compute.</para>
+    <procedure>
+        <title>To load an ISO image to an Image Service data
+            store</title>
+        <step>
+            <para>Obtain the ISO image. For example,
+                <filename>ubuntu-13.04-server-amd64.iso</filename>.</para>
+        </step>
+        <step>
+            <para>In the Image Service, run the following
+                command:</para>
+            <screen><prompt>$</prompt> <userinput>glance image-create --name ubuntu.iso \
+   --is-public=True --container-format=bare \
+   --disk-format=iso &lt; ubuntu-13.04-server-amd64.iso</userinput></screen>
+            <para>In this command, <literal>ubuntu.iso</literal> is
+                the name for the ISO image after it is loaded to the
+                Image Service, and
+                    <literal>ubuntu-13.04-server-amd64.iso</literal>
+                is the name of the source ISO image.</para>
+        </step>
+        <step>
+            <para>Optionally, confirm the upload in Compute.</para>
+            <para>Run this command:</para>
+            <screen><prompt>$</prompt> <userinput>nova image-list</userinput></screen>
+        </step>
+    </procedure>
+    <procedure>
+        <title>To boot an instance from an ISO image</title>
+        <step>
+            <para>Run this command:</para>
+            <screen><prompt>$</prompt> <userinput>nova boot --image ubuntu.iso \
+  --flavor 1 instance_name</userinput></screen>
+            <para>In this command, <literal>ubuntu.iso</literal> is
+                the ISO image, and <literal>instance_name</literal> is
+                the name of the new instance.</para>
+        </step>
+    </procedure>
+</section>