openstack-manuals/doc/common/section_glance_image-formats.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

102 lines
4.2 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<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="image-formats">
<title>Disk and Container Formats for Images</title>
<?dbhtml stop-chunking?>
<para>When you add an image to the Image Service, you can specify
its disk and container formats.</para>
<section xml:id="disk-format">
<title>Disk Formats</title>
<para>The disk format of a virtual machine image is the format
of the underlying disk image. Virtual appliance vendors
have different formats for laying out the information
contained in a virtual machine disk image.</para>
<para>Set the disk format for your image to one of the
following values:</para>
<itemizedlist>
<listitem>
<para><literal>raw</literal>. An unstructured disk
image format; if you have a file without an
extension it is possibly a raw format</para>
</listitem>
<listitem>
<para><literal>vhd</literal>. The VHD disk format, a
common disk format used by virtual machine
monitors from VMWare, Xen, Microsoft, VirtualBox,
and others</para>
</listitem>
<listitem>
<para><literal>vmdk</literal>. Common disk format
supported by many common virtual machine
monitors</para>
</listitem>
<listitem>
<para><literal>vdi</literal>. Supported by VirtualBox
virtual machine monitor and the QEMU
emulator</para>
</listitem>
<listitem>
<para><literal>iso</literal>. An archive format for
the data contents of an optical disc, such as
CD-ROM.</para>
</listitem>
<listitem>
<para><literal>qcow2</literal>. Supported by the QEMU
emulator that can expand dynamically and supports
Copy on Write</para>
</listitem>
<listitem>
<para><literal>aki</literal>. An Amazon kernel
image.</para>
</listitem>
<listitem>
<para><literal>ari</literal>. An Amazon ramdisk
image.</para>
</listitem>
<listitem>
<para><literal>ami</literal>. An Amazon machine
image.</para>
</listitem>
</itemizedlist>
</section>
<section xml:id="container-format">
<title>Container Formats</title>
<para>The container format indicates whether the virtual
machine image is in a file format that also contains
metadata about the actual virtual machine.</para>
<note>
<para>The Image Service and other OpenStack projects do
not currently support the container format. It is safe
to specify <literal>bare</literal> as the container
format if you are unsure.</para>
</note>
<para>You can set the container format for your image to one
of the following values:</para>
<itemizedlist>
<listitem>
<para><literal>bare</literal>. The image does not have
a container or metadata envelope.</para>
</listitem>
<listitem>
<para><literal>ovf</literal>. The OVF container
format.</para>
</listitem>
<listitem>
<para><literal>aki</literal>. An Amazon kernel image.
</para>
</listitem>
<listitem>
<para><literal>ari</literal>. An Amazon ramdisk
image.</para>
</listitem>
<listitem>
<para><literal>ami</literal>. An Amazon machine
image.</para>
</listitem>
</itemizedlist>
</section>
</section>