Skip to content

Commit e2152ae

Browse files
author
Amelia Shull
committed
add info on accelnet for custom images
1 parent d00a3ce commit e2152ae

File tree

2 files changed

+27
-2
lines changed

2 files changed

+27
-2
lines changed

articles/virtual-network/accelerated-networking-overview.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -100,9 +100,18 @@ You can directly query the list of VM SKUs that support Accelerated Networking b
100100
101101
### Custom VM images
102102

103-
If you use a custom image that supports Accelerated Networking, make sure you have the required drivers to work with Mellanox ConnectX-3, ConnectX-4 Lx, and ConnectX-5 NICs on Azure. Accelerated Networking also requires network configurations that exempt configuration of the virtual functions on the mlx4_en and mlx5_core drivers.
103+
If you use a custom image that supports Accelerated Networking, make sure you meet the following requirements.
104104

105-
Images with cloud-init version 19.4 or later have networking correctly configured to support Accelerated Networking during provisioning.
105+
#### Device and driver support
106+
Any custom image supporting AccelNet must include drivers that enable Single Root I/O Virtualization for the network interface cards (NIC) which are used on Azure platforms. This hardware list includes NVIDIA [ConnectX-3](https://network.nvidia.com/pdf/user_manuals/ConnectX-3_Ethernet_Single_and_Dual_SFP+_Port_Adapter_Card_User_Manual.pdf), [ConnectX-4 Lx](https://docs.nvidia.com/networking/display/cx4lxen), [ConnectX-5](https://docs.nvidia.com/networking/display/connectx5en) and the [Microsoft Azure Network Adapter (MANA)](https://learn.microsoft.com/en-us/azure/virtual-network/accelerated-networking-mana-overview). Download and install the latest versions of these drivers into your custom image.
107+
108+
#### Dynamic binding and revocation of virtual function
109+
Binding to the synthetic NIC that's exposed in the VM is a mandatory requirement for all applications that take advantage of AccelNet. If an application runs directly over the VF NIC, it doesn't receive all packets that are destined to the VM, because some packets show up over the synthetic interface. You must run an application over the synthetic NIC to guarantee that the application receives all packets that are destined to it. Binding to the synthetic NIC also ensures that the application keeps running even if the VF is revoked during host servicing.
110+
111+
For more information about application binding requirements, see [How Accelerated Networking works in Linux and FreeBSD VMs](./create-vm-accelerated-networking-cli?tabs=windows#handle-dynamic-binding-and-revocation-of-virtual-function).
112+
113+
#### Configure drivers to be unmanaged
114+
AccelNet requires network configurations that mark the NVIDIA drivers as unmanaged devices. Images with cloud-init version 19.4 or later have networking correctly configured to support AccelNet during provisioning.
106115

107116
# [RHEL, CentOS](#tab/redhat)
108117

@@ -153,6 +162,17 @@ EOF
153162
>[!NOTE]
154163
>We strongly advise that you don't run competing network interface software (such as ifupdown and networkd) on custom images, and that you don't run dhcpclient directly on multiple interfaces.
155164
165+
#### Verify data path
166+
To ensure your custom image will support AccelNet, confirm that networking traffic is using the AccelNet data path.
167+
168+
For NVIDIA drivers: Verify that the packets are flowing over the VF interface
169+
- [Linux documentation](./accelerated-networking-how-it-works#application-usage)
170+
- [Windows documentation](./create-vm-accelerated-networking-cli?tabs=windows#confirm-that-accelerated-networking-is-enabled)
171+
172+
For MANA driver: Verify that the traffic is flowing through MANA
173+
- [Linux documentation](./accelerated-networking-mana-linux#verify-that-traffic-is-flowing-through-mana)
174+
- [Windows documentation](./accelerated-networking-mana-windows#verify-that-traffic-is-flowing-through-mana)
175+
156176
---
157177

158178
## Next steps

articles/virtual-network/create-vm-accelerated-networking-cli.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,11 @@ Once you create the VM in Azure, connect to the VM and confirm that the Ethernet
197197

198198
The presence of the adapter confirms that Accelerated Networking is enabled for your VM.
199199

200+
1. Verify the packets are flowing over the VF interface from the output of the following command:
201+
```powershell
202+
PS C:\ > Get-NetAdapter | Where-Object InterfaceDescription –like "*Mellanox*Virtual*" | Get-NetAdapterStatistics
203+
```
204+
200205
> [!NOTE]
201206
> If the Mellanox adapter fails to start, open an administrator command prompt on the remote VM and enter the following command:
202207
>

0 commit comments

Comments
 (0)