openstack-manuals/doc/user-guide/section_dashboard_launch_instances_from_volume.xml
Diane Fleming 64b6c9261e Folder rename, file rename, flattening of directories
Current folder name	New folder name	        Book title
----------------------------------------------------------
basic-install 	        DELETE
cli-guide	        DELETE
common	                common
NEW	                admin-guide-cloud	Cloud Administrators Guide
docbkx-example	        DELETE
openstack-block-storage-admin 	DELETE
openstack-compute-admin 	DELETE
openstack-config 	config-reference	OpenStack Configuration Reference
openstack-ha 	        high-availability-guide	OpenStack High Availabilty Guide
openstack-image	        image-guide	OpenStack Virtual Machine Image Guide
openstack-install 	install-guide	OpenStack Installation Guide
openstack-network-connectivity-admin 	admin-guide-network 	OpenStack Networking Administration Guide
openstack-object-storage-admin 	DELETE
openstack-security 	security-guide	OpenStack Security Guide
openstack-training 	training-guide	OpenStack Training Guide
openstack-user 	        user-guide	OpenStack End User Guide
openstack-user-admin 	user-guide-admin	OpenStack Admin User Guide
glossary	        NEW        	OpenStack Glossary

bug: #1220407

Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7
author: diane fleming
2013-09-08 15:15:50 -07:00

75 lines
3.1 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>
<!--<title>To launch an instance from a volume</title> -->
<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/trunk/openstack-image/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>