openstack/openstack-manuals
Code Issues Proposed changes

Merge "Adds hypervisor_version_requires (ImagePropertiesFilter)"

Browse Source
This commit is contained in:
Jenkins 2015-03-13 05:40:59 +00:00 committed by Gerrit Code Review
commit ba2dc5aa5e
1 changed files with 36 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
doc/config-reference/compute/section_compute-scheduler.xml
View File

@ -478,35 +478,54 @@ aggregate_image_properties_isolation_separator = .</programlisting>
instance's image. It passes hosts that can support the instance's image. It passes hosts that can support the
specified image properties contained in the instance. specified image properties contained in the instance.
Properties include the architecture, hypervisor type, Properties include the architecture, hypervisor type,
and virtual machine mode. for example, an instance hypervisor version (for Xen hypervisor type only),
might require a host that runs an ARM-based processor and virtual machine mode.</para>
and QEMU as the hypervisor. An image can be decorated <para>For example, an instance
might require a host that runs an ARM-based processor,
and QEMU as the hypervisor. You can decorate an image
with these properties by using:</para> with these properties by using:</para>
<screen><prompt>$</prompt> <userinput>glance image-update img-uuid --property architecture=arm --property hypervisor_type=qemu</userinput></screen> <screen><prompt>$</prompt> <userinput>glance image-update img-uuid --property architecture=arm --property hypervisor_type=qemu</userinput></screen>
<para>The image properties that the filter checks for <para>The image properties that the filter checks for are:</para>
are:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><literal>architecture</literal>: <para><literal>architecture</literal>:
Architecture describes the machine describes the machine
architecture required by the image. Examples architecture required by the image. Examples
are i686, x86_64, arm, and ppc64.</para> are <literal>i686</literal>, <literal>x86_64</literal>,
<literal>arm</literal>, and <literal>ppc64</literal>.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><literal>hypervisor_type</literal>: <para><literal>hypervisor_type</literal>:
Hypervisor type describes the hypervisor describes the hypervisor required by the image.
required by the image. Examples are xen, qemu, Examples are <literal>xen</literal>,
and xenapi. Note that qemu is used for both <literal>qemu</literal>, and <literal>xenapi</literal>.</para>
QEMU and KVM hypervisor types.</para> <note><para><literal>qemu</literal> is used for both
QEMU and KVM hypervisor types.</para></note>
</listitem> </listitem>
<listitem> <listitem>
<para><literal>vm_mode</literal>: Virtual machine <para><literal>hypervisor_version_requires</literal>:
mode describes the hypervisor application describes the hypervisor version required by the image.
The property is supported for Xen hypervisor type only.
It can be used to enable support
for multiple hypervisor versions,
and to prevent instances with newer
Xen tools from being provisioned on an older version
of a hypervisor. If available, the property value
is compared to the hypervisor version of the compute host.</para>
<para>To filter the hosts by the hypervisor version,
add the <literal>hypervisor_version_requires</literal> property
on the image as metadata and pass an operator and a
required hypervisor version as its value:</para>
<screen><prompt>$</prompt> <userinput>glance image-update img-uuid --property hypervisor_type=xen --property hypervisor_version_requires=">=4.3"</userinput></screen>
</listitem>
<listitem>
<para><literal>vm_mode</literal>: describes the hypervisor application
binary interface (ABI) required by the image. binary interface (ABI) required by the image.
Examples are 'xen' for Xen 3.0 paravirtual Examples are <literal>xen</literal> for Xen 3.0 paravirtual
ABI, 'hvm' for native ABI, 'uml' for User Mode ABI, <literal>hvm</literal> for native ABI,
Linux paravirtual ABI, exe for container virt <literal>uml</literal> for User Mode
executable ABI.</para> Linux paravirtual ABI, <literal>exe</literal>
for container virt executable ABI.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section> </section>