Manage accelerated networking for Azure Virtual Machines

The article discusses how to enable and manage Accelerated Networking on existing Azure Virtual Machines.

Prerequisites

An Azure account with an active subscription. You can create an account for free.

An Azure account with an active subscription. You can create an account for free.

Azure Cloud Shell

Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. You can use either Bash or PowerShell with Cloud Shell to work with Azure services. You can use the Cloud Shell preinstalled commands to run the code in this article, without having to install anything on your local environment.

To start Azure Cloud Shell:

Option	Example/Link
Select Try It in the upper-right corner of a code or command block. Selecting Try It doesn't automatically copy the code or command to Cloud Shell.
Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser.
Select the Cloud Shell button on the menu bar at the upper right in the Azure portal.

To use Azure Cloud Shell:

Start Cloud Shell.
Select the Copy button on a code block (or command block) to copy the code or command.
Paste the code or command into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux, or by selecting Cmd+Shift+V on macOS.
Select Enter to run the code or command.

If you choose to install and use PowerShell locally, this article requires the Azure PowerShell module version 1.0.0 or later. Run Get-Module -ListAvailable Az to find the installed version. If you need to upgrade, see Install Azure PowerShell module. If you're running PowerShell locally, you also need to run Connect-AzAccount to create a connection with Azure.

Handle dynamic binding and revocation of virtual function

Binding to the synthetic network interface exposed in the virtual machine is a mandatory requirement for all applications that take advantage of Accelerated Networking.

Applications running directly over the virtual function network interface miss some packets destined for the virtual machine. These packets appear over the synthetic interface instead.

You must run an application over the synthetic network interface to guarantee that the application receives all packets that are destined to it. Binding to the synthetic network interface also ensures that the application keeps running even if the virtual function is revoked during host servicing.

For more information about application binding requirements, see How Accelerated Networking works in Linux and FreeBSD VMs.

Test the functionality on any Windows Hyper-V server to ensure that your custom image or applications correctly support the dynamic binding and revocation of virtual functions. Use a local Windows Server running Hyper-V in the following configuration:

Ensure you have a physical network adapter that supports SR-IOV.
An external virtual switch is created on top of this SR-IOV adapter with "Enable single-root I/O virtualization (SR-IOV)" checked.
A virtual machine running your operating system image or application is created/deployed.
The network adapters for this virtual machine, under Hardware Acceleration, have "Enable SR-IOV" selected.

Once you've verified your virtual machine and application are leveraging a network adapter using SR-IOV, you can modify the following example commands to toggle SR-IOV off/on in order to revoke and add the virtual function which will simulate what happens during Azure host servicing:

# Get the virtual network adapter to test
$vmNic = Get-VMNetworkAdapter -VMName "myvm" | where {$_.MacAddress -eq "001122334455"}

# Enable SR-IOV on a virtual network adapter
Set-VMNetworkAdapter $vmNic -IovWeight 100 -IovQueuePairsRequested 1

# Disable SR-IOV on a virtual network adapter
Set-VMNetworkAdapter $vmNic -IovWeight 0

Manage Accelerated Networking on existing VMs

It's possible to enable Accelerated Networking on an existing VM. The VM must meet the following requirements to support Accelerated Networking:

A supported size for Accelerated Networking.
A supported Azure Marketplace image and kernel version for Linux.
Stopped or deallocated before you can enable Accelerated Networking on any NIC. This requirement applies to all individual VMs or VMs in an availability set or Azure Virtual Machine Scale Sets.

Enable Accelerated Networking on individual VMs or VMs in availability sets

When you create a VM in the Azure portal, you can select the Enable accelerated networking checkbox on the Networking tab of the Create a virtual machine screen.

If the VM uses a supported operating system and VM size for Accelerated Networking, the Enable accelerated networking checkbox on the Networking tab of the Create a virtual machine screen is automatically selected. If Accelerated Networking isn't supported, the checkbox isn't selected, and a message explains the reason.

Note

You can enable Accelerated Networking during portal VM creation only for Azure Marketplace supported operating systems. To create and enable Accelerated Networking for a VM with a custom OS image, you must use Azure CLI or PowerShell.

To enable or disable Accelerated Networking for an existing VM through the Azure portal:

From the Azure portal page for the VM, select Networking from the left menu.
On the Networking page, select the Network Interface.
At the top of the NIC Overview page, select Edit accelerated networking.
Select Automatic, Enabled, or Disabled, and then select Save.

To confirm whether Accelerated Networking is enabled for an existing VM:

From the Azure portal page for the VM, select Networking from the left menu.
On the Networking page, select the Network Interface.
On the NIC Overview page, under Essentials, note whether Accelerated networking is set to Enabled or Disabled.

Stop or deallocate the VM or, if an availability set, all the VMs in the set:
```
Stop-AzVM -ResourceGroup "<myResourceGroup>" -Name "<myVM>"
```
If you created your VM individually without an availability set, you must stop or deallocate only the individual VM to enable Accelerated Networking. If you created your VM with an availability set, you must stop or deallocate all VMs in the set, so the VMs end up on a cluster that supports Accelerated Networking.

The stop or deallocate requirement is unnecessary to disable Accelerated Networking. Clusters that support Accelerated Networking also work fine with NICs that don't use Accelerated Networking.

Enable Accelerated Networking on the NIC of your VM:

$nic = Get-AzNetworkInterface -ResourceGroupName "<myResourceGroup>" -Name "<myNic>"

$nic.EnableAcceleratedNetworking = $true

$nic | Set-AzNetworkInterface

Restart your VM, or all the VMs in the availability set, and confirm that Accelerated Networking is enabled.
```
Start-AzVM -ResourceGroup "<myResourceGroup>" -Name "<myVM>"
```

Enable Accelerated Networking on Virtual Machine Scale Sets

Azure Virtual Machine Scale Sets is slightly different but follows the same workflow.

Stop the VMs:

Stop-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myScaleSet>"

Update the Accelerated Networking property under the NIC:

$vmss = Get-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myScaleSet>"

$vmss.VirtualMachineProfile.NetworkProfile.NetworkInterfaceConfigurations[0].EnableAcceleratedNetworking = $true

Update-AzVmss 
  -ResourceGroupName "<myResourceGroup>" `
  -VMScaleSetName "<myScaleSet>" `
  -VirtualMachineScaleSet $vmss

Virtual Machine Scale Sets has an upgrade policy that applies updates by using automatic, rolling, or manual settings. Set the upgrade policy to automatic so that the changes are immediately picked up.
```
$vmss.UpgradePolicy.Mode = "Automatic"

Update-AzVmss 
  -ResourceGroupName "<myResourceGroup>" `
  -VMScaleSetName "<myScaleSet>" `
  -VirtualMachineScaleSet $vmss
```

Restart the scale set:

Start-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myScaleSet>"

First, stop and deallocate the VM, or all the VMs in the availability set.
```
az vm deallocate \
  --resource-group <myResourceGroup> \
  --name <myVm>
```
If you created your VM individually without an availability set, you must stop or deallocate only the individual VM to enable Accelerated Networking. If you created your VM with an availability set, you must stop or deallocate all VMs in the set before you can enable Accelerated Networking on any of the NICs.

Once the VM is stopped, enable Accelerated Networking on the NIC of your VM.

az network nic update \
  --name <myNic> \
  --resource-group <myResourceGroup> \
  --accelerated-networking true

Restart your VM, or all the VMs in the availability set, and confirm that Accelerated Networking is enabled.
```
az vm start --resource-group <myResourceGroup> \
  --name <myVm>
```

Enable Accelerated Networking on Virtual Machine Scale Sets

Azure Virtual Machine Scale Sets is slightly different, but follows the same workflow.

First, stop the VMs:

az vmss deallocate \
  --name <myVmss> \
  --resource-group <myResourceGroup>

Once the VMs are stopped, update the Accelerated Networking property under the network interface.

az vmss update --name <myVmss> \
  --resource-group <myResourceGroup> \
  --set virtualMachineProfile.networkProfile.networkInterfaceConfigurations[0].enableAcceleratedNetworking=true

Virtual Machine Scale Sets has an upgrade policy that applies updates by using automatic, rolling, or manual settings. The following instructions set the policy to automatic so Virtual Machine Scale Sets picks up the changes immediately after restart.
```
az vmss update \
  --name <myVmss> \
  --resource-group <myResourceGroup> \
  --set upgradePolicy.mode="automatic"
```

Finally, restart Virtual Machine Scale Sets.

az vmss start \
  --name <myVmss> \
  --resource-group <myResourceGroup>

Once you restart and the upgrades finish, the VF appears inside VMs that use a supported OS and VM size.

Resize existing VMs with Accelerated Networking

You can resize VMs with Accelerated Networking enabled only to sizes that also support Accelerated Networking. You can't resize a VM with Accelerated Networking to a VM instance that doesn't support Accelerated Networking by using the resize operation. Instead, use the following process to resize these VMs:

Stop and deallocate the VM or all the VMs in the availability set or Virtual Machine Scale Sets.
Disable Accelerated Networking on the NIC of the VM or all the VMs in the availability set or Virtual Machine Scale Sets.
Move the VM or VMs to a new size that doesn't support Accelerated Networking, and restart them.

Create an Azure Virtual Machine with Accelerated Networking

Feedback

Was this page helpful?

Last updated on 2025-01-08