openstack-manuals/doc/user-guide/section_dashboard_launch_instances_from_volume.xml
Diane Fleming 69b79de7b9 Update headings plus edits for consistency and clarity in End and Admin User Guides
Partial-Bug: #1250515

author: diane fleming

Change-Id: I0ae7f3da1ef0bf9af4900097d527e2cd7b94c966
backport: havana
2013-11-16 14:41:21 -06:00

74 lines
3.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!-- Some useful entities borrowed from HTML -->
<!ENTITY ndash "&#x2013;">
<!ENTITY mdash "&#x2014;">
<!ENTITY hellip "&#x2026;">
]>
<section 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"
xml:id="dashboard_launch_instances_from_volume">
<title>Launch an instance from a volume</title>
<?dbhtml stop-chunking?>
<para>You can launch an instance directly from an image that has
been copied to a persistent volume.</para>
<procedure>
<step>
<para>Create a volume that is large enough to store an
unzipped image.</para>
</step>
<step>
<para>Create an image.</para>
<para>For details, see <link
xlink:href="http://docs.openstack.org/image-guide/content/ch_creating_images_manually.html"
>Creating images manually</link> in the
<citetitle>OpenStack Virtual Machine Image
Guide</citetitle>.</para>
</step>
<step>
<para>Launch an instance.</para>
</step>
<step>
<para>Attach the volume to the instance.</para>
</step>
<step>
<para>Assuming that the attached volume is mounted as
<literal>/dev/vdb</literal>, use one of the
following commands to copy the image to the attached
volume:</para>
<itemizedlist>
<listitem>
<para>For a raw image:</para>
<screen><prompt>$</prompt> <userinput>cat IMAGE >/dev/vdb</userinput></screen>
<para>Alternatively, use
<command>dd</command>.</para>
</listitem>
<listitem>
<para>For a non-raw image:</para>
<screen><prompt>$</prompt> <userinput>qemu-img convert -O raw IMAGE /dev/vdb</userinput></screen>
</listitem>
<listitem>
<para>For a *.tar.bz2 image:</para>
<screen><prompt>$</prompt> <userinput>tar xfjO IMAGE >/dev/vdb</userinput></screen>
</listitem>
</itemizedlist>
</step>
<step>
<para>Because only <emphasis role="italic"
>detached</emphasis> volumes are available for
booting, detach the volume.</para>
</step>
<step>
<para>Now, you can launch an instance from an image
that has been copied to the volume. The
instance is booted from the volume, which is provided
by <systemitem class="service"
>nova-volume</systemitem> through iSCSI. To launch
an instance from the volume, see <xref
linkend="dashboard_launch_instances_from_image"
/>.</para>
</step>
</procedure>
</section>