• No results found

Appendix A. Image Configuration Parameters

The following keys, together with the components to which they are specific, can be used with the pro perty option for both the g l ance i mag upd ate and g l ance i mag e-create commands.

Examp le A.1.

$ glance image-update IMG-UUID --property architecture=x86_64

No t e

Behavior set using image properties overrides behavior set using flavors. For more information, see Section 3, “ Manage Flavors”.

T ab le A.1. Pro p ert y keys

The CPU architecture that must be supported by the hypervisor.

For example, x86 _6 4 , arm, or ppc6 4 . Run uname -m to get the architecture of a machine.

We strongly recommend using the architecture data vocabulary defined by the libosinfo project for this purpose.

al pha–DEC 64-bit RISC armv7l –ARM Cortex-A7 MPCore

cri s–Ethernet, Token Ring, AXis–Code Reduced

Instruction Set

i 6 86 –Intel sixth-generation x86 (P6 micro architecture) i a6 4 –Itanium

l m32–Lattice Micro32 m6 8k–Motorola 68000 mi cro bl aze–Xilinx 32-bit FPGA (Big Endian)

mi cro bl azeel –Xilinx 32-bit FPGA (Little Endian)

mi ps–MIPS 32-bit RISC (Big Endian)

mi psel –MIPS 32-bit RISC (Little Endian)

mi ps6 4 –MIPS 64-bit RISC

pari sc6 4 –HP Precision Architecture 64-bit RISC

ppc–PowerPC 32-bit ppc6 4 –PowerPC 64-bit ppcemb–PowerPC (Embedded 32-bit) s39 0 –IBM Enterprise Systems Architecture/390 x86 _6 4 –64-bit extension of IA-32 fully supported by Red Hat are i 6 86 and x86 _6 4 . Sp ecif i

c t o

Key Descrip t io n Su p p o rt ed valu es

All hypervis or_type

The hypervisor type. kvm, vmware

All instance

_uuid

For snapshot images, this is the UUID of the server used to create this image.

Valid server UUID

All kernel_id The ID of an image stored in the Image Service that should be used as the kernel when booting an AMI-style image.

Valid image ID

All os_distr o

The common name of the operating system distribution in lowercase (uses the same data vocabulary as the libosinfo project). Specify only a

recognized value for this field.

Deprecated values are listed to assist you in searching for the recognized value.

arch–Arch Linux. Do not use archl i nux or g ento o –Gentoo Linux. Do not use G ento o or

o rg . g ento o

mand rake–Mandrakelinux (MandrakeSoft) distribution.

Do not use mand rakel i nux or Mand rakeLi nux

netbsd –NetBSD. Do not use NetBSD or o rg . netbsd netware–Novell NetWare. Do Sp ecif i

c t o

Key Descrip t io n Su p p o rt ed valu es

o penbsd –OpenBSD. Do not use O penBSD or

o rg . o penbsd

o penso l ari s–OpenSolaris.

Do not use O penSo l ari s or sl ed –SUSE Linux Enterprise Desktop. Do not use

co m. suse

ubuntu–Ubuntu. Do not use Ubuntu, co m. ubuntu, o rg . ubuntu, or cano ni cal

wi nd o ws–Microsoft Windows. Do not use co m. mi cro so ft. server

All os_versi on

The operating system version as specified by the distributor.

Version number (for example,

"11.10")

All ramdisk_

id

The ID of image stored in the Image Service that should be used as the ramdisk when booting an AMI-style image.

Valid image ID

All vm_mod

e

The virtual machine mode. This represents the host/guest ABI (application binary interface) used for the virtual machine.

hvm–Fully virtualized. This is the mode used by QEMU and KVM.

libvirt API driver

hw_disk _bus

Specifies the type of disk

controller to attach disk devices to.

scsi , vi rti o , i d e, or usb.

Sp ecif i c t o

Key Descrip t io n Su p p o rt ed valu es

libvirt

generator device to the image's instances. The cloud specify a physical HW RNG device, use the following option in the no va. co nf file:

vi rti o , or other supported device.

Enables the use of VirtIO SCSI (virtio-scsi) to provide block device access for compute instances; by default, instances use VirtIO Block (virtio-blk).

VirtIO SCSI is a para-virtualized SCSI controller device that

The video image driver used. vg a, ci rrus, vmvg a, xen, or q xl

Maximum RAM for the video image. Used only if a

hw_vi d eo : ram_max_mb value has been set in the flavor's extra_specs and that value is higher than the value set in hw_vi d eo _ram.

Integer in MB (for example, '64') Sp ecif i

c t o

Key Descrip t io n Su p p o rt ed valu es

​rng_dev_path=/dev/hwrn g

libvirt watchdog device that carries out the specified action if the server hangs. The watchdog uses the i6300esb device (emulating a PCI Intel 6300ESB). If

hw_watchd o g _acti o n is not specified, the watchdog is disabled.

d i sabl ed –(default) The device is not attached. Allows the user to disable the

watchdog for the image, even if it has been enabled using the image's flavor. watchdog; do nothing if the server hangs.

The kernel command line to be used by the libvirt driver, instead of the default. For linux

containers (LXC), the value is used as arguments for

initialization. This key is valid only for Amazon kernel, ramdisk, or machine images (aki, ari, or ami).

Specifies the model of virtual

network interface device to use. The valid options depend on the configured hypervisor.

KVM and QEMU: e10 0 0 , ne2k_pci , pcnet, rtl 8139 , and vi rti o .

VMware: e10 0 0 , e10 0 0 e, Vi rtual E10 0 0 ,

Vi rtual E10 0 0 e, Vi rtual P C Net32,

Vi rtual Sri o vEthernetC a rd , and Vi rtual Vmxnet.

Xen: e10 0 0 , netfro nt, ne2k_pci , pcnet, and rtl 8139 .

The virtual SCSI or IDE controller used by the

VMware installed in the image. This value is passed to the hypervisor when creating a virtual machine. If not specified, the key defaults to o therG uest.

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 ext3 or ext4 format.

true | fal se

XenAPI driver

os_type The operating system installed on the image. The XenAPI driver contains logic that takes

different actions depending on the value of the o s_type parameter of the image. For example, for

o s_type= wi nd o ws 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.

l i nux or wi nd o ws Sp ecif i

c t o

Key Descrip t io n Su p p o rt ed valu es