Skip to content

Commit 4452fd5

Browse files
Merge pull request #288980 from halkazwini/vnet-acc
Accelnet custom image information
2 parents 81bf0db + 811bf28 commit 4452fd5

File tree

2 files changed

+38
-12
lines changed

2 files changed

+38
-12
lines changed

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

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Accelerated Networking overview
33
description: Learn how Accelerated Networking can improve the networking performance of Azure VMs.
4-
author: EllieMelissa
4+
author: mattreatMSFT
5+
ms.author: mareat
56
ms.service: azure-virtual-network
6-
ms.custom: linux-related-content
77
ms.topic: how-to
8-
ms.date: 04/18/2023
9-
ms.author: ealume
8+
ms.date: 10/22/2024
9+
ms.custom: linux-related-content
1010
---
1111

1212
# Accelerated Networking overview
@@ -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.
104+
105+
#### Device and driver support
106+
Any custom image supporting Accelerated Networking 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, ConnectX-4 Lx, ConnectX-5 and the [Microsoft Azure Network Adapter (MANA)](accelerated-networking-mana-overview.md).
107+
108+
#### Dynamic binding and revocation of virtual function
109+
Accelerated Networking requires guest OS images to properly handle the virtual function being removed or added dynamically. Scenarios such as host maintenance or live migration will result in dynamic revocation of the virtual function and restoration after the maintenance event. Additionally, applications must ensure that they bind to the synthetic device and not the virtual function in order to maintain network connectivity during these events.
104110

105-
Images with cloud-init version 19.4 or later have networking correctly configured to support Accelerated Networking during provisioning.
111+
For more information about application binding requirements, see [How Accelerated Networking works in Linux and FreeBSD VMs](create-vm-accelerated-networking-cli.md?tabs=windows#handle-dynamic-binding-and-revocation-of-virtual-function).
112+
113+
#### Configure drivers to be unmanaged
114+
Accelerated Networking 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 Accelerated Networking during provisioning. 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.
106115

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

@@ -150,12 +159,19 @@ Unmanaged=yes
150159
EOF
151160
```
152161

153-
>[!NOTE]
154-
>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.
162+
#### Network traffic uses the Accelerated Networking data path
163+
164+
For NVIDIA drivers: Verify that the packets are flowing over the VF interface
165+
- [Linux documentation](accelerated-networking-how-it-works.md#application-usage)
166+
- [Windows documentation](create-vm-accelerated-networking-cli.md?tabs=windows#confirm-that-accelerated-networking-is-enabled)
167+
168+
For MANA driver: Verify that the traffic is flowing through MANA
169+
- [Linux documentation](accelerated-networking-mana-linux.md#verify-that-traffic-is-flowing-through-mana)
170+
- [Windows documentation](accelerated-networking-mana-windows.md#verify-that-traffic-is-flowing-through-mana)
155171

156172
---
157173

158-
## Next steps
174+
## Related content
159175

160176
- [How Accelerated Networking works in Linux and FreeBSD VMs](./accelerated-networking-how-it-works.md)
161177
- [Create a VM with Accelerated Networking by using PowerShell](./create-vm-accelerated-networking-powershell.md)

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

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
---
22
title: Use Azure CLI to create a Windows or Linux VM with Accelerated Networking
33
description: Use Azure CLI to create and manage virtual machines that have Accelerated Networking enabled for improved network performance.
4-
author: steveesp
4+
author: mattreatMSFT
5+
ms.author: mareat
56
ms.service: azure-virtual-network
67
ms.topic: how-to
7-
ms.date: 04/18/2023
8-
ms.author: steveesp
8+
ms.date: 10/22/2024
99
ms.custom: fasttrack-edit, devx-track-azurecli, linux-related-content
1010
---
11+
1112
# Use Azure CLI to create a Windows or Linux VM with Accelerated Networking
1213

1314
> [!CAUTION]
@@ -197,6 +198,15 @@ Once you create the VM in Azure, connect to the VM and confirm that the Ethernet
197198

198199
The presence of the adapter confirms that Accelerated Networking is enabled for your VM.
199200

201+
1. Verify the packets are flowing over the VF interface from the output of the following command:
202+
```powershell
203+
PS C:\ > Get-NetAdapter | Where-Object InterfaceDescription –like "*Mellanox*Virtual*" | Get-NetAdapterStatistics
204+
205+
Name ReceivedBytes ReceivedUnicastPackets SentBytes SentUnicastPackets
206+
---- ------------- ---------------------- --------- ------------------
207+
Ethernet 2 492447549 347643 7468446 34991
208+
```
209+
200210
> [!NOTE]
201211
> If the Mellanox adapter fails to start, open an administrator command prompt on the remote VM and enter the following command:
202212
>

0 commit comments

Comments
 (0)