Skip to content

Commit 9c626b8

Browse files
author
Manika Dhiman
committed
PM feedback
1 parent fc1d797 commit 9c626b8

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

azure-local/upgrade/install-enable-network-atc.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,17 @@ author: ronmiab
55
ms.author: robess
66
ms.topic: how-to
77
ms.reviewer: alkohli
8-
ms.date: 06/03/2025
8+
ms.date: 06/05/2025
99
ms.service: azure-local
1010
---
1111

1212
# Configure Network ATC on Azure Local
1313

14-
This article describes how to configure Network ATC on an existing Azure Local system that doesn't already have it configured.
14+
This article describes how to configure Network ATC on an existing Azure Local cluster that doesn't already have it configured.
1515

1616
> [!IMPORTANT]
1717
> In Azure Local upgrade scenarios where Network ATC isn't already configured, we recommend upgrading the operating system first, then configuring Network ATC, and then proceeding with the solution upgrade.
18-
> If Network ATC is already configured on your system, you don't need to repeat the installation and configuration.
18+
> If Network ATC is already configured on your cluster, you don't need to repeat the installation and configuration.
1919
> For more information on upgrades, see [About Azure Local upgrades](./about-upgrades-23h2.md).
2020
2121
## About Network ATC
@@ -33,24 +33,24 @@ Network ATC provides the following benefits for Azure Local:
3333

3434
## Key considerations
3535

36-
Before you install and enable Network ATC on your existing Azure Local, ensure the following conditions are met:
36+
Before you configure Network ATC on your existing Azure Local, ensure the following conditions are met:
3737

3838
- The host doesn't have any running VM on it.
39-
- The system is actively running workloads. If there are no running workloads on your Azure Local instance, you can optionally remove all virtual switches and QoS policies, then add your intents using the standard procedures described in [Deploy host networking with Network ATC](/windows-server/networking/network-atc/network-atc).
40-
- All checkpoints associated with your VMs are removed. Failure to do so may result in live migration failure between hosts.
39+
- The cluster is actively running workloads. If there are no running workloads on your Azure Local cluster, you can optionally remove all virtual switches and QoS policies, then add your intents using the standard procedures described in [Deploy host networking with Network ATC](/windows-server/networking/network-atc/network-atc).
40+
- All checkpoints associated with your VMs are removed. Failure to do so will result in live migration failure between hosts.
4141

4242
## Step 1: Install Network ATC
4343

44-
In this step, you install Network ATC on every machine in the system using the following command. No reboot is required.
44+
In this step, you install Network ATC and the required FS-SMBBW feature on every machine in the cluster using the following command. No reboot is required.
4545

4646
```powershell
4747
Install-WindowsFeature -Name NetworkATC
4848
Install-WindowsFeature -Name FS-SMBBW
4949
```
5050

51-
## Step 2: Pause one machine in the system
51+
## Step 2: Pause one machine in the cluster
5252

53-
When you pause one machine in the system, all workloads are moved to other machines, making your machine available for changes. The paused machine is then migrated to Network ATC.
53+
When you pause one machine in the cluster, all workloads are moved to other machines, making your machine available for changes. The paused machine is then migrated to Network ATC.
5454

5555
To pause your machine, use the following command:
5656

@@ -73,13 +73,13 @@ Set-Service -Name NetworkATC -StartupType Disabled
7373

7474
Remove any previous configurations from the paused machine that could interfere with Network ATC’s ability to apply the new intent. The previous configurations include:
7575

76-
- Data Center Bridging (NetQos) policy for RDMA traffic
76+
- Data Center Bridging (NetQos) policies for RDMA traffic
7777
- Load Balancing Failover (LBFO)
7878

7979
Although Network ATC attempts to adopt existing configurations with matching names, including NetQos and other settings, it’s easier to remove the current configuration and allow Network ATC to redeploy the necessary configuration items and more.
8080

8181
> [!IMPORTANT]
82-
> Previous versions of this document recommended deleting the Switch Embedded Teaming (SET) virtual switch and allowing Network ATC to recreate it. However, deleting the virtual switch can result in unexpected connectivity loss and may disrupt existing Software Defined Networking (SDN) deployments.
82+
> Previous versions of this document recommended deleting the Switch Embedded Teaming (SET) virtual switch and allowing Network ATC to recreate it. However, deleting the virtual switch can result in unexpected connectivity loss and will disrupt existing Software Defined Networking (SDN) deployments.
8383
> The current recommended method is to rename the SET virtual switch and virtual NICs to the expected Network ATC convention, which is performed in a later step.
8484
8585
To remove your existing NetQos configurations, use the following commands:
@@ -133,7 +133,7 @@ Some Azure Local deployments require a VLAN to be configured on the management o
133133
Set-VMNetworkAdapterIsolation -ManagementOS -VMNetworkAdapterName "vNICName" -IsolationMode Vlan -AllowUntaggedTraffic $true -DefaultIsolationID 100
134134
```
135135
136-
1. Complete these steps for all management and storage virtual network adapters present on the system. If neither output had a VLAN configured, move to the next step.
136+
1. Complete these steps for all management and storage virtual network adapters present on the cluster. If neither output had a VLAN configured, move to the next step.
137137
138138
## Step 6: Plan and deploy the intents
139139
@@ -143,7 +143,7 @@ Once you identify the example that matches your environment, use the commands pr
143143
144144
## Step 7: Verify the deployment on one machine
145145
146-
The `Get-NetIntentStatus` command shows the deployment status of the requested intents. The result returns one object per intent for each machine in the system.
146+
The `Get-NetIntentStatus` command shows the deployment status of the requested intents. The result returns one object per intent for each machine in the cluster.
147147
148148
To verify your machine's successful deployment of the intents submitted in [step 6](#step-6-plan-and-deploy-the-intents), run the following command:
149149
@@ -178,9 +178,9 @@ If `ConfigurationStatus` shows **Failed**, check if the error message indicates
178178

179179
## Step 8: Resume the paused node
180180

181-
With the Network ATC configuration completed on the first node, resume the node and allow it to come back into the cluster.
181+
With the Network ATC configuration completed on the first node, resume the node and allow it to come back into the cluster.
182182

183-
1. To reenter or put your system back in service, run the following command:
183+
1. To reenter or put your cluster back in service, run the following command:
184184

185185
```powershell
186186
Resume-ClusterNode
@@ -218,7 +218,7 @@ In this step, you move from the machine deployed with Network ATC to the next ma
218218
219219
You don't change the Network ATC `VMSwitch` for two reasons:
220220
221-
- Network ATC ensures that all machines in the system have the same name to support live migration and symmetry.
221+
- Network ATC ensures that all machines in the cluster have the same name to support live migration and symmetry.
222222
- Network ATC implements and controls the names of configuration objects. Otherwise, you'd need to ensure this configuration artifact is perfectly deployed.
223223
224224
## Step 10: Apply the required changes to the remaining cluster nodes

0 commit comments

Comments
 (0)