Page History

...

Virtual machines are running on the same storage device (local storage or share strage). Because of the rate limitation of device (such as iops), if one VM has large disk operation, it may affect the disk performance of other VMs running on the same storage device.
It is neccesary to set the maximum rate and limit the disk I/O of VMs.

Target Branch

4.2.0

Feature Specifications

• set the maximum rate of VMs (in service_offering, disk_offering, and global configuration)
• change the maximum rate of VMs
• limit the disk rate (total bps and iops)

Use cases

TBD

Architecture and Design description

• change service_offering and disk_offering table in cloud database.
  alter table service_offering add column total_bytes_sec bigint(20) unsigned default 0;
  alter table service_offering add column total_iops_sec bigint(20) unsigned default 0;

alter table disk_offering add column total_bytes_sec bigint(20) unsigned default 0;
alter table disk_offering add column total_iops_sec bigint(20) unsigned default 0;

• add global configurations
  INSERT IGNORE INTO `cloud`.`configuration` VALUES ('Advanced', 'DEFAULT', 'management-server', 'vm.disk.throttling.io_rate', 0, 'Default disk I/O rate in requests per second allowed in User vm\'s disk. ');
  INSERT IGNORE INTO `cloud`.`configuration` VALUES ('Advanced', 'DEFAULT', 'management-server', 'vm.disk.throttling.bytes_rate', 0, 'Default disk I/O rate in bytes per second allowed in User vm\'s disk. ');

• change kvm/LibvirtComputingResource to support IO Throttling (need the support from libvirt-0...jar)
  com.cloud.hypervisor.kvm.resource.LibvirtDomainXMLParser.parseDomainXML(String)
  com.cloud.hypervisor.kvm.resource.LibvirtVMDef.DiskDef
  com.cloud.hypervisor.kvm.resource.LibvirtComputingResource

• change APIs (createServiceOffering, createDiskOffering)change APIs
• change the CloudStack UI (Compute offering, system offering, disk offering)

Web Services APIs and Responses

createServiceOffering: Creates a service offering.
updateServiceOffering createDiskOffering: Updates a service offering.Creates a disk offering.

ServiceOfferingResponse: response of createServiceOffering/update/list
DiskOfferingResponse: response of createDiskOffering/update/list

ApiResponseHelper.createServiceOfferingResponse: create service offering response
ApiResponseHelper.createDiskOfferingResponse: create disk offering response

UI flow

add "Disk Rate (BPS)" and "Disk I/O Rate (IOPS)" in "Add Disk Offering"
add "Disk I/O RateOfferings ( compute,system,disk)
display "Disk Rate (BPS)" and "Disk Rate (IOPS)" in the detail page of unique disk offeringofferings.

References

• Features/DiskIOLimits : http://wiki.qemu.org/Features/DiskIOLimits
• Testcase Virtualization IO Throttling: https://fedoraproject.org/wiki/QA:Testcase_Virtualization_IO_Throttling
• I/O throttling is experimentally supported from QEMU 1.1 : http://wiki.qemu.org/ChangeLog/1.1#Block_devices
• Libvirt Domain XML format (Disk) : http://libvirt.org/formatdomain.html#elementsDisks

...