Skip to content

Commit 7e25e54

Browse files
Merge pull request #234981 from asudbring/linux-fixes
[Doc-a-thon] Linux doc-athon fixes for Use Azure CLI to create a Windows or Linux VM with Accelerated Networking
2 parents c858b85 + 0beb598 commit 7e25e54

File tree

1 file changed

+20
-11
lines changed

1 file changed

+20
-11
lines changed

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

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,10 @@
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-
services: virtual-network
54
author: asudbring
6-
manager: gedegrac
7-
tags: azure-resource-manager
85
ms.service: virtual-network
96
ms.topic: how-to
10-
ms.workload: infrastructure-services
11-
ms.date: 03/20/2023
7+
ms.date: 04/18/2023
128
ms.author: allensu
139
ms.custom: fasttrack-edit, devx-track-azurecli
1410
---
@@ -23,6 +19,7 @@ To use Azure PowerShell to create a Windows VM with Accelerated Networking enabl
2319
## Prerequisites
2420

2521
- An Azure account with an active subscription. You can [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
22+
2623
- The latest version of [Azure CLI installed](/cli/azure/install-azure-cli). Sign in to Azure by using the [az login](/cli/azure/reference-index#az-login) command.
2724

2825
## Create a VM with Accelerated Networking
@@ -139,7 +136,7 @@ az vm create \
139136

140137
# [Linux](#tab/linux)
141138

142-
The following example creates a VM with the UbuntuLTS OS image and a size that supports Accelerated Networking, Standard_DS4_v2.
139+
The following example creates a VM with a size that supports Accelerated Networking, Standard_DS4_v2.
143140

144141
```azurecli
145142
az vm create \
@@ -206,11 +203,11 @@ Once you create the VM in Azure, connect to the VM and confirm that the Ethernet
206203

207204
1. Use the following command to create an SSH session with the VM. Replace `<myPublicIp>` with the public IP address assigned to the VM you created, and replace `<myAdminUser>` with the `--admin-username` you specified when you created the VM.
208205

209-
```bash
206+
```azurecli
210207
ssh <myAdminUser>@<myPublicIp>
211208
```
212209

213-
1. From a Bash shell on the remote VM, enter `uname -r` and confirm that the kernel version is one of the following versions, or greater:
210+
1. From a shell on the remote VM, enter `uname -r` and confirm that the kernel version is one of the following versions, or greater:
214211

215212
- **Ubuntu 16.04**: 4.11.0-1013.
216213
- **SLES SP3**: 4.4.92-6.18.
@@ -252,13 +249,16 @@ You must run an application over the synthetic NIC to guarantee that the applica
252249
For more information about application binding requirements, see [How Accelerated Networking works in Linux and FreeBSD VMs](./accelerated-networking-how-it-works.md#application-usage).
253250

254251
<a name="enable-accelerated-networking-on-existing-vms"></a>
252+
255253
## Manage Accelerated Networking on existing VMs
256254

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

259-
- Be a supported size for Accelerated Networking.
260-
- Be a supported Azure Marketplace image and kernel version for Linux.
261-
- Be 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.
257+
- A supported size for Accelerated Networking.
258+
259+
- A supported Azure Marketplace image and kernel version for Linux.
260+
261+
- 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.
262262

263263
### Enable Accelerated Networking on individual VMs or VMs in availability sets
264264

@@ -332,7 +332,9 @@ Once you restart and the upgrades finish, the VF appears inside VMs that use a s
332332
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:
333333

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

338340
## Manage Accelerated Networking through the portal
@@ -349,18 +351,25 @@ If the VM uses a [supported operating system](./accelerated-networking-overview.
349351
To enable or disable Accelerated Networking for an existing VM through the Azure portal:
350352

351353
1. From the [Azure portal](https://portal.azure.com) page for the VM, select **Networking** from the left menu.
354+
352355
1. On the **Networking** page, select the **Network Interface**.
356+
353357
1. At the top of the NIC **Overview** page, select **Edit accelerated networking**.
358+
354359
1. Select **Automatic**, **Enabled**, or **Disabled**, and then select **Save**.
355360

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

358363
1. From the portal page for the VM, select **Networking** from the left menu.
364+
359365
1. On the **Networking** page, select the **Network Interface**.
366+
360367
1. On the network interface **Overview** page, under **Essentials**, note whether **Accelerated networking** is set to **Enabled** or **Disabled**.
361368

362369
## Next steps
363370

364371
- [How Accelerated Networking works in Linux and FreeBSD VMs](./accelerated-networking-how-it-works.md)
372+
365373
- [Create a VM with Accelerated Networking by using PowerShell](../virtual-network/create-vm-accelerated-networking-powershell.md)
374+
366375
- [Proximity placement groups](../virtual-machines/co-location.md)

0 commit comments

Comments
 (0)