LibvirtCustomHardware - Revision history

Kragniz: /* Image metadata properties */

2015-01-19T11:52:05Z

‎Image metadata properties

Russellb: /* Image metadata properties */ add hw_ prefix to other options, too

2013-06-04T12:44:31Z

‎Image metadata properties: add hw_ prefix to other options, too

Russellb: /* Image metadata properties */ s/nic_model/hw_vif_model/ to reflect current state of the code

2013-06-04T12:43:31Z

‎Image metadata properties: s/nic_model/hw_vif_model/ to reflect current state of the code

Ryan Lane: Text replace - "NOTOC" to ""

2013-02-17T23:30:04Z

Text replace - "__NOTOC__" to ""

DanielBerrange at 17:47, 21 January 2013

2013-01-21T17:47:27Z

DanielBerrange at 17:44, 21 January 2013

2013-01-21T17:44:01Z

New page

__NOTOC__
= Libvirt Custom Hardware Configuration =
Currently libvirt will determine the disk / cdrom / nic device models based on the configured hypervisor type (libvirt_type in /etc/nova/nova.conf). For sake of optimal performance, it will default to using virtio for both disk and nic models. The downside of this approach is that it is not possible to run operating systems which lack virtio drivers. eg BSD, Solaris, old Linux, old Windows.

Just changing the defaults won't help because, even ignoring the performance implications of pocking a non-virtio model, there is no single disk / nic model that will satisfy every operating system. Thus there needs to be a way to request custom hardware models.

== Image metadata properties ==
Glance has the ability to store arbitrary metadata properties against images. This provides a way to let the user request specific hardware models

It is anticipated that the user will be allowed three properties

* disk_bus - specify the type of disk controller to attach disk devices to - one of scsi, virtio, uml, xen, ide, usb
* cdrom_bus - specify the type of disk controller to attach cdrom devices to - one of scsi, virtio, uml, xen, ide, usb
* nic_model - specify the model of the network interface device - one of 'e1000', 'rtl8139', 'xen', 'virtio', 'uml'

These can be set at time of image upload to glance, or after the face

<pre><nowiki>
# glance image-update \
--property disk_bus=scsi \
--property cdrom_bus=ide \
--property nic_model=e1000 \
f16-x86_64-openstack-sda
</nowiki></pre>

← Older revision		Revision as of 11:52, 19 January 2015
Line 14:		Line 14:
	* nic_model - specify the model of the network interface device - one of 'e1000', 'rtl8139', 'xen', 'virtio', 'uml'		* nic_model - specify the model of the network interface device - one of 'e1000', 'rtl8139', 'xen', 'virtio', 'uml'

−	These can be set at time of image upload to glance, or after the ~~face~~	+	These can be set at time of image upload to glance, or after the fact.

← Older revision		Revision as of 17:47, 21 January 2013
Line 24:		Line 24:
	f16-x86_64-openstack-sda		f16-x86_64-openstack-sda
	</nowiki></pre>		</nowiki></pre>
		+
		+	The property names and values were chosen such that they can be applicable to other non-libvirt hypervisors. This avoids the mess that would entail from multiple properties like 'libvirt_disk_bus', 'xenapi_disk_bus', 'vmware_disk_bus'. Any hypervisor can interpret values like 'ide', 'scsi', etc into something sensible

@@ Line 19: / Line 19: @@
 <pre><nowiki>
 # glance image-update \
-     --property disk_bus=scsi \
+     --property hw_disk_bus=scsi \
-     --property cdrom_bus=ide \
+     --property hw_cdrom_bus=ide \
      --property hw_vif_model=e1000 \
      f16-x86_64-openstack-sda

@@ Line 1: / Line 1: @@
-__NOTOC__
 = Libvirt Custom Hardware Configuration =
 Currently libvirt will determine the disk / cdrom / nic device models based on the configured hypervisor type (libvirt_type in /etc/nova/nova.conf). For sake of optimal performance, it will default to using virtio for both disk and nic models. The downside of this approach is that it is not possible to run operating systems which lack virtio drivers. eg BSD, Solaris, old Linux, old Windows.