9f208d1b08
Moved listings for property keys and values into the CLI. Removed listing from Image, and replaced with reference. Edited Image Guide section, and added Compute config and image-show example. Partial-Bug: #1304114 Change-Id: I84bd59bab2eda16adbe80641fcb95c55959f5d9d
271 lines
19 KiB
XML
271 lines
19 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE chapter [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
]>
|
|
<chapter 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="chapter_cli-glance-property">
|
|
<!-- This file is manually generated, unlike many of the other chapters. -->
|
|
<title>Image Service property keys</title>
|
|
<para>The following keys, together with the components to which they are specific, can be used
|
|
with the <option>property</option> option for both the <command>glance
|
|
image-update</command> and <command>glance image-create</command> commands. For
|
|
example:</para>
|
|
<screen><prompt>$</prompt> <userinput>glance image-update <replaceable>img-uuid</replaceable> --property architecture=x86_64</userinput></screen>
|
|
<table rules="all">
|
|
<caption>Property keys</caption>
|
|
<col width="12%"/>
|
|
<col width="12%"/>
|
|
<col width="38%"/>
|
|
<col width="38%"/>
|
|
<thead>
|
|
<tr>
|
|
<th>Specific to</th>
|
|
<th>Key</th>
|
|
<th>Description</th>
|
|
<th>Supported values</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>architecture</td>
|
|
<td>The CPU architecture that must be supported by
|
|
the hypervisor. For example,
|
|
<literal>x86_64</literal>, <literal>arm</literal>, or <literal>ppc64</literal>. Run
|
|
<command>uname -m</command> to get the architecture of a
|
|
machine. We strongly recommend using the architecture data vocabulary
|
|
defined by the <link xlink:href="http://libosinfo.org">libosinfo project</link>
|
|
for this purpose.</td>
|
|
<td>
|
|
<itemizedlist>
|
|
<listitem><para><literal>alpha</literal> — <link xlink:href="http://en.wikipedia.org/wiki/DEC_Alpha"
|
|
>DEC 64-bit RISC</link></para></listitem>
|
|
<listitem><para><literal>armv7l</literal> — <link xlink:href="http://en.wikipedia.org/wiki/ARM_architecture"
|
|
>ARM Cortex-A7 MPCore</link></para></listitem>
|
|
<listitem><para><literal>cris</literal> — <link xlink:href="http://en.wikipedia.org/wiki/ETRAX_CRIS"
|
|
>Ethernet, Token Ring, AXis — Code Reduced Instruction Set</link></para></listitem>
|
|
<listitem><para><literal>i686</literal> — <link xlink:href="http://en.wikipedia.org/wiki/X86"
|
|
>Intel sixth-generation x86</link>
|
|
(P6 micro architecture)</para></listitem>
|
|
<listitem><para><literal>ia64</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Itanium"
|
|
>Itanium</link></para></listitem>
|
|
<listitem><para><literal>lm32</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Milkymist"
|
|
>Lattice Micro32</link></para></listitem>
|
|
<listitem><para><literal>m68k</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Motorola_68000_family"
|
|
>Motorola 68000</link></para></listitem>
|
|
<listitem><para><literal>microblaze</literal> — <link xlink:href="http://en.wikipedia.org/wiki/MicroBlaze"
|
|
>Xilinx 32-bit FPGA (Big Endian)</link></para></listitem>
|
|
<listitem><para><literal>microblazeel</literal> — <link xlink:href="http://en.wikipedia.org/wiki/MicroBlaze"
|
|
>Xilinx 32-bit FPGA (Little Endian)</link></para></listitem>
|
|
<listitem><para><literal>mips</literal> — <link xlink:href="http://en.wikipedia.org/wiki/MIPS_architecture"
|
|
>MIPS 32-bit RISC (Big Endian)</link></para></listitem>
|
|
<listitem><para><literal>mipsel</literal> — <link xlink:href="http://en.wikipedia.org/wiki/MIPS_architecture"
|
|
>MIPS 32-bit RISC (Little Endian)</link></para></listitem>
|
|
<listitem><para><literal>mips64</literal> — <link xlink:href="http://en.wikipedia.org/wiki/MIPS_architecture"
|
|
>MIPS 64-bit RISC (Big Endian)</link></para></listitem>
|
|
<listitem><para><literal>mips64el</literal> — <link xlink:href="http://en.wikipedia.org/wiki/MIPS_architecture"
|
|
>MIPS 64-bit RISC (Little Endian)</link></para></listitem>
|
|
<listitem><para><literal>openrisc</literal> — <link xlink:href="http://en.wikipedia.org/wiki/OpenRISC#QEMU_support"
|
|
>OpenCores RISC</link></para></listitem>
|
|
<listitem><para><literal>parisc</literal> — <link xlink:href="http://en.wikipedia.org/wiki/PA-RISC"
|
|
>HP Precision Architecture RISC</link></para></listitem>
|
|
<listitem><para><literal>parisc64</literal> — <link xlink:href="http://en.wikipedia.org/wiki/PA-RISC"
|
|
>HP Precision Architecture 64-bit RISC</link></para></listitem>
|
|
<listitem><para><literal>ppc</literal> — <link xlink:href="http://en.wikipedia.org/wiki/PowerPC"
|
|
>PowerPC 32-bit</link></para></listitem>
|
|
<listitem><para><literal>ppc64</literal> — <link xlink:href="http://en.wikipedia.org/wiki/PowerPC"
|
|
>PowerPC 64-bit</link></para></listitem>
|
|
<listitem><para><literal>ppcemb</literal> — <link xlink:href="http://en.wikipedia.org/wiki/PowerPC"
|
|
>PowerPC (Embedded 32-bit)</link></para></listitem>
|
|
<listitem><para><literal>s390</literal> — <link xlink:href="http://en.wikipedia.org/wiki/S390"
|
|
>IBM Enterprise Systems Architecture/390</link></para></listitem>
|
|
<listitem><para><literal>s390x</literal> — <link xlink:href="http://en.wikipedia.org/wiki/S390x"
|
|
>S/390 64-bit</link></para></listitem>
|
|
<listitem><para><literal>sh4</literal> — <link xlink:href="http://en.wikipedia.org/wiki/SuperH"
|
|
>SuperH SH-4 (Little Endian)</link></para></listitem>
|
|
<listitem><para><literal>sh4eb</literal> — <link xlink:href="http://en.wikipedia.org/wiki/SuperH"
|
|
>SuperH SH-4 (Big Endian)</link></para></listitem>
|
|
<listitem><para><literal>sparc</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Sparc"
|
|
>Scalable Processor Architecture, 32-bit</link></para></listitem>
|
|
<listitem><para><literal>sparc64</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Sparc"
|
|
>Scalable Processor Architecture, 64-bit</link></para></listitem>
|
|
<listitem><para><literal>unicore32</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Unicore"
|
|
>Microprocessor Research and Development Center
|
|
RISC Unicore32</link></para></listitem>
|
|
<listitem><para><literal>x86_64</literal> — <link xlink:href="http://en.wikipedia.org/wiki/X86"
|
|
>64-bit extension of IA-32</link></para></listitem>
|
|
<listitem><para><literal>xtensa</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Xtensa#Processor_Cores"
|
|
>Tensilica Xtensa configurable microprocessor core</link></para></listitem>
|
|
<listitem><para><literal>xtensaeb</literal> — <link xlink:href="http://en.wikipedia.org/wiki/Xtensa#Processor_Cores"
|
|
>Tensilica Xtensa configurable microprocessor core
|
|
(Big Endian)</link></para></listitem>
|
|
</itemizedlist>
|
|
</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>hypervisor_type</td>
|
|
<td>The hypervisor type.</td>
|
|
<td><literal>xen</literal>, <literal>qemu</literal>, <literal>kvm</literal>,
|
|
<literal>lxc</literal>, <literal>uml</literal>, <literal>vmware</literal>,
|
|
or <literal>hyperv</literal></td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>instance_uuid</td>
|
|
<td>For snapshot images, this is the UUID of the server used to create this image.</td>
|
|
<td>Valid server UUID</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>kernel_id</td>
|
|
<td>The ID of an image stored in the Image Service that should be used as the kernel
|
|
when booting an AMI-style image.</td>
|
|
<td>Valid image ID</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>os_distro</td>
|
|
<td>The common name of the operating system distribution in lowercase (uses the same
|
|
data vocabulary as the <link xlink:href="http://libosinfo.org">libosinfo
|
|
project</link>). Specify only a recognized value for this field. Deprecated
|
|
values are listed to assist you in searching for the recognized value.</td>
|
|
<td>
|
|
<itemizedlist>
|
|
<listitem><para><literal>arch</literal> — Arch Linux. Do not use <literal>archlinux</literal> or
|
|
<literal>org.archlinux</literal></para></listitem>
|
|
<listitem><para><literal>centos</literal> — Community Enterprise Operating System. Do not use
|
|
<literal>org.centos</literal> or
|
|
<literal>CentOS</literal></para></listitem>
|
|
<listitem><para><literal>debian</literal> — Debian. Do not use <literal>Debian</literal> or
|
|
<literal>org.debian</literal></para></listitem>
|
|
<listitem><para><literal>fedora</literal> — Fedora. Do not use <literal>Fedora</literal>,
|
|
<literal>org.fedora</literal>, or
|
|
<literal>org.fedoraproject</literal></para></listitem>
|
|
<listitem><para><literal>freebsd</literal> — FreeBSD. Do not use <literal>org.freebsd</literal>,
|
|
<literal>freeBSD</literal>, or <literal>FreeBSD</literal></para></listitem>
|
|
<listitem><para><literal>gentoo</literal> — Gentoo Linux. Do not use <literal>Gentoo</literal> or
|
|
<literal>org.gentoo</literal></para></listitem>
|
|
<listitem><para><literal>mandrake</literal> — Mandrakelinux (MandrakeSoft) distribution. Do not use
|
|
<literal>mandrakelinux</literal> or
|
|
<literal>MandrakeLinux</literal></para></listitem>
|
|
<listitem><para><literal>mandriva</literal> — Mandriva Linux. Do not use
|
|
<literal>mandrivalinux</literal></para></listitem>
|
|
<listitem><para><literal>mes</literal> — Mandriva Enterprise Server. Do not use
|
|
<literal>mandrivaent</literal> or
|
|
<literal>mandrivaES</literal></para></listitem>
|
|
<listitem><para><literal>msdos</literal> — Microsoft Disc Operating System. Do not use
|
|
<literal>ms-dos</literal></para></listitem>
|
|
<listitem><para><literal>netbsd</literal> — NetBSD. Do not use <literal>NetBSD</literal> or
|
|
<literal>org.netbsd</literal></para></listitem>
|
|
<listitem><para><literal>netware</literal> — Novell NetWare. Do not use <literal>novell</literal> or
|
|
<literal>NetWare</literal></para></listitem>
|
|
<listitem><para><literal>openbsd</literal> — OpenBSD. Do not use <literal>OpenBSD</literal> or
|
|
<literal>org.openbsd</literal></para></listitem>
|
|
<listitem><para><literal>opensolaris</literal> — OpenSolaris. Do not use <literal>OpenSolaris</literal>
|
|
or <literal>org.opensolaris</literal></para></listitem>
|
|
<listitem><para><literal>opensuse</literal> — openSUSE. Do not use <literal>suse</literal>,
|
|
<literal>SuSE</literal>, or
|
|
<literal>org.opensuse</literal></para></listitem>
|
|
<listitem><para><literal>rhel</literal> — Red Hat Enterprise Linux. Do not use
|
|
<literal>redhat</literal>, <literal>RedHat</literal>, or
|
|
<literal>com.redhat</literal></para></listitem>
|
|
<listitem><para><literal>sled</literal> — SUSE Linux Enterprise Desktop. Do not use
|
|
<literal>com.suse</literal></para></listitem>
|
|
<listitem><para><literal>ubuntu</literal> — Ubuntu. Do not use <literal>Ubuntu</literal>,
|
|
<literal>com.ubuntu</literal>, <literal>org.ubuntu</literal>, or
|
|
<literal>canonical</literal></para></listitem>
|
|
<listitem><para><literal>windows</literal> — Microsoft Windows. Do not use
|
|
<literal>com.microsoft.server</literal> or
|
|
<literal>windoze</literal></para></listitem>
|
|
</itemizedlist>
|
|
</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>os_version</td>
|
|
<td>The operating system version as specified by the distributor.</td>
|
|
<td>Version number (for example, "11.10")</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>ramdisk_id</td>
|
|
<td>The ID of image stored in the Image Service that should be used as the ramdisk
|
|
when booting an AMI-style image.</td>
|
|
<td>Valid image ID</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>All</td>
|
|
<td>vm_mode</td>
|
|
<td>The virtual machine mode. This represents the host/guest ABI (application binary
|
|
interface) used for the virtual machine.</td>
|
|
<td>
|
|
<itemizedlist>
|
|
<listitem><para><literal>hvm</literal> — Fully virtualized. This is the mode used by QEMU and
|
|
KVM.</para></listitem>
|
|
<listitem><para><literal>xen</literal> — Xen 3.0 paravirtualized.</para></listitem>
|
|
<listitem><para><literal>uml</literal> — User Mode Linux paravirtualized.</para></listitem>
|
|
<listitem><para><literal>exe</literal> — Executables in containers. This is the mode used by
|
|
LXC.</para></listitem>
|
|
</itemizedlist>
|
|
</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>libvirt API driver</td>
|
|
<td>hw_video_model</td>
|
|
<td>The video image driver used.</td>
|
|
<td><literal>vga</literal>, <literal>cirrus</literal>, <literal>vmvga</literal>,
|
|
<literal>xen</literal>, or <literal>qxl</literal></td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>VMware API driver</td>
|
|
<td>vmware_adaptertype</td>
|
|
<td>The virtual SCSI or IDE controller used by the hypervisor.</td>
|
|
<td><literal>lsiLogic</literal>, <literal>busLogic</literal>, or
|
|
<literal>ide</literal></td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>VMware API driver</td>
|
|
<td>vmware_ostype</td>
|
|
<td>A VMware GuestID which describes the operating system installed in the image.
|
|
This value is passed to the hypervisor when creating a virtual machine. If not
|
|
specified, the key defaults to <literal>otherGuest</literal>.</td>
|
|
<td>See <link xlink:href="http://www.thinkvirt.com/?q=node/181"
|
|
>thinkvirt.com</link>.</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>VMware API driver</td>
|
|
<td>vmware_image_version</td>
|
|
<td>Currently unused.</td>
|
|
<td><literal>1</literal></td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>XenAPI driver</td>
|
|
<td>auto_disk_config</td>
|
|
<td>If true, the root partition on the disk is automatically resized before the
|
|
instance boots. This value is only taken into account by the Compute service
|
|
when using a Xen-based hypervisor with the XenAPI driver. The Compute service
|
|
will only attempt to resize if there is a single partition on the image, and
|
|
only if the partition is in <literal>ext3</literal> or <literal>ext4</literal>
|
|
format.</td>
|
|
<td>true | false</td>
|
|
</tr>
|
|
<tr valign="top">
|
|
<td>XenAPI driver</td>
|
|
<td>os_type</td>
|
|
<td>The operating system installed on the image. The XenAPI driver contains logic
|
|
that takes different actions depending on the value of the
|
|
<literal>os_type</literal> parameter of the image. For example, for
|
|
<literal>os_type=windows</literal> images, it creates a FAT32-based swap
|
|
partition instead of a Linux swap partition, and it limits the injected host
|
|
name to less than 16 characters.</td>
|
|
<td><literal>linux</literal> or <literal>windows</literal></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</chapter> |