You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: azure-local/upgrade/install-enable-network-atc.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,17 +5,17 @@ author: ronmiab
5
5
ms.author: robess
6
6
ms.topic: how-to
7
7
ms.reviewer: alkohli
8
-
ms.date: 06/03/2025
8
+
ms.date: 06/05/2025
9
9
ms.service: azure-local
10
10
---
11
11
12
12
# Configure Network ATC on Azure Local
13
13
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.
15
15
16
16
> [!IMPORTANT]
17
17
> 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.
19
19
> For more information on upgrades, see [About Azure Local upgrades](./about-upgrades-23h2.md).
20
20
21
21
## About Network ATC
@@ -33,24 +33,24 @@ Network ATC provides the following benefits for Azure Local:
33
33
34
34
## Key considerations
35
35
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:
37
37
38
38
- 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.
41
41
42
42
## Step 1: Install Network ATC
43
43
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.
45
45
46
46
```powershell
47
47
Install-WindowsFeature -Name NetworkATC
48
48
Install-WindowsFeature -Name FS-SMBBW
49
49
```
50
50
51
-
## Step 2: Pause one machine in the system
51
+
## Step 2: Pause one machine in the cluster
52
52
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.
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:
75
75
76
-
- Data Center Bridging (NetQos) policy for RDMA traffic
76
+
- Data Center Bridging (NetQos) policies for RDMA traffic
77
77
- Load Balancing Failover (LBFO)
78
78
79
79
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.
80
80
81
81
> [!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.
83
83
> 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.
84
84
85
85
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
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.
137
137
138
138
## Step 6: Plan and deploy the intents
139
139
@@ -143,7 +143,7 @@ Once you identify the example that matches your environment, use the commands pr
143
143
144
144
## Step 7: Verify the deployment on one machine
145
145
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.
147
147
148
148
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:
149
149
@@ -178,9 +178,9 @@ If `ConfigurationStatus` shows **Failed**, check if the error message indicates
178
178
179
179
## Step 8: Resume the paused node
180
180
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.
182
182
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:
184
184
185
185
```powershell
186
186
Resume-ClusterNode
@@ -218,7 +218,7 @@ In this step, you move from the machine deployed with Network ATC to the next ma
218
218
219
219
You don't change the Network ATC `VMSwitch` for two reasons:
220
220
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.
222
222
- Network ATC implements and controls the names of configuration objects. Otherwise, you'd need to ensure this configuration artifact is perfectly deployed.
223
223
224
224
## Step 10: Apply the required changes to the remaining cluster nodes
0 commit comments