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/manage/troubleshoot-deployment.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Learn how to troubleshoot the deployment validation failures for Az
4
4
ms.topic: how-to
5
5
ms.author: alkohli
6
6
author: alkohli
7
-
ms.date: 04/11/2025
7
+
ms.date: 04/14/2025
8
8
---
9
9
10
10
@@ -46,19 +46,19 @@ The issue occurs for the following reason:
46
46
47
47
The multi-step resolution process includes the following steps:
48
48
49
-
-[Remove the lock from the seed node](#remove-the-lock-from-the-seed-node)
49
+
-[Remove the lock from the first machine](#remove-the-lock-from-the-first-machine)
50
50
-[Remove the validation error](#remove-the-validation-error)
51
51
-[Clean up the Edge Device Azure Resource with incorrect VM switch information](#clean-up-the-edge-device-azure-resource-with-incorrect-vm-switch-information)
52
52
-[Refresh the cloud data](#refresh-the-cloud-edgedevices-data)
53
53
-[Restart the deployment via Azure portal](#restart-the-deployment-via-azure-portal)
54
-
-[Recreate the lock on the seed node](#recreate-the-lock-on-the-seed-node)
54
+
-[Recreate the lock on the first machine](#recreate-the-lock-on-the-first-machine)
55
55
56
56
> [!NOTE]
57
-
> All the steps in this article need to be performed on the seed node.
57
+
> All the steps in this article need to be performed on the first machine.
58
58
59
-
### Remove the lock from the seed node
59
+
### Remove the lock from the first machine
60
60
61
-
Follow these steps to remove the lock from the seed node:
61
+
Follow these steps to remove the lock from the first machine:
62
62
63
63
1. To remove the lock, in the Azure portal, go to the object via the resource group or within Machines - Azure Arc.
64
64
1. In the left-pane, go to **Settings > Locks**. You should see a lock named **DoNotDelete**. This is the automatic resource lock that is created when the node is onboarded.
@@ -83,7 +83,7 @@ Message: The scope '/subscriptions/<subid>/resourceGroups/<rgname>/providers/Mic
83
83
84
84
With the lock removed, follow these steps to remove the validation error.
85
85
86
-
1. Connect to the seed node. Run the following PowerShell command:
86
+
1. Connect to the first machine. Run the following PowerShell command:
87
87
88
88
```PowerShell
89
89
Get-VMSwitch
@@ -143,7 +143,7 @@ After the VM switch on the device is removed, clean up the Edge Device ARM resou
1. After confirming the `show` command worked by outputting the `edgeDevices` data, and likely confirming the `"switchDetails"`, it is time to `delete` the resource from ARM so it can be refreshed appropriately from the seed node.
146
+
1. After confirming the `show` command worked by outputting the `edgeDevices` data, and likely confirming the `"switchDetails"`, it is time to `delete` the resource from ARM so it can be refreshed appropriately from the first machine.
147
147
148
148
> [!NOTE]
149
149
> Deleting the `edgeDevices` data is a safe action to perform, but it should only be performed when explicitly stated. Do not perform this action unless advised to do so.
@@ -182,7 +182,7 @@ With the ARM resource and all the unintentional VM switches removed, refresh the
182
182
183
183
Follow these steps to refresh the cloud data:
184
184
185
-
1. Restart the `DeviceManagementService` on the seed node. Run the following PowerShell command:
185
+
1. Restart the `DeviceManagementService` on the first machine. Run the following PowerShell command:
186
186
187
187
```PowerShell
188
188
Restart-Service DeviceManagementService
@@ -211,9 +211,9 @@ Follow these steps in the Azure portal:
211
211
212
212
1. If no other validation issues occur, start the deployment.
213
213
214
-
### Recreate the lock on the seed node
214
+
### Recreate the lock on the first machine
215
215
216
-
After the mitigation is complete, we strongly recommend that you recreate the lock on the seed node.
216
+
After the mitigation is complete, we strongly recommend that you recreate the lock on the first machine.
0 commit comments