Enabling Network throttling for VMs on Hyper-V

Bug Reference

CLOUDSTACK-6262

Branch

4.4, Master

Introduction

Network throttling is the process of controlling the network access and bandwidth usage based on certain rules. It controls the maximum bandwidth which can be allocated to VM. The benefit here is that you may have very noisy VMs on host that consume a lot of bandwidth, and they can be stepped down yet still given an adequate amount of connectivity.

Purpose

This is functional specification for Enabling Network throttling for VMs on Hyper-V

References

• Network Throttling in CloudStack
• QoS Overview for Windows Server 2012 R2
• Msvm_EthernetSwitchPortBandwidthSettingData class

Document History

Glossary

VM - virtual machine running on hypervisor

NIC - network interface controller which is attached to VM

Feature Specifications

• In this feature we are starting to use the network rate parameter which is sent with StartCommand.
• StartCommand is used to deploy the VM.
• Network rate parameter is 

Currently network rate parameter which is passed during deployment of VM is not honored in Hyper-V. With this we will apply that parameter to maximum bandwidth allowed for VM. This parameter will be applied to NIC and controls the max data transfer date rate of the NIC and will apply to both ingress and egress traffic combined .

• One can see whether settings got applied successfully by verifying the VM -> settings--> network adapter --> bandwidth management --> maximum bandwidth in Hyper-V Manager.
• To see how network throttling rate applies on VM see network throtling .
  
  

Use cases

With this we can control the max bandwidth allocated for VM, which helps in controlling the bandwidth alloction to noisy VMs which otherwise may consume the whole bandwidth and degrades the performance

Architecture and Design description

Web Services APIs

No new APIs are added for this feature. Existing APIs which will be used for this feature are

• createNetworkOffering, one can specify the networkrate for network throttling
• createServiceOffering, one can specify the networkrate for network throttling

To see how network throttling rate applies on VM see network throtling .

UI flow

No new UI screens are introduced by this feature. Also, no changes need to be made in UI for enabling network throttling for VMs on Hyper-V. The UI workflow looks as follows.

Specifying Network Rate

There are two places where one can specify the network rate for network throttling

• One can specify network rate parameter  while creating service offering
• One can specify network rate parameter while creating network offering

To see how network throttling rate applies on VM see network throtling .

IP Clearance

  No IP dependencies are introduced by this feature.

Appendix

Appendix A:

Appendix B: