Skip to content

Commit c4b5e08

Browse files
committed
Updated with suggestions from Ronmia.
1 parent 3fc1045 commit c4b5e08

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

azure-local/manage/troubleshoot-deployment.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to troubleshoot the deployment validation failures for Az
44
ms.topic: how-to
55
ms.author: alkohli
66
author: alkohli
7-
ms.date: 04/11/2025
7+
ms.date: 04/14/2025
88
---
99

1010

@@ -46,19 +46,19 @@ The issue occurs for the following reason:
4646

4747
The multi-step resolution process includes the following steps:
4848

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)
5050
- [Remove the validation error](#remove-the-validation-error)
5151
- [Clean up the Edge Device Azure Resource with incorrect VM switch information](#clean-up-the-edge-device-azure-resource-with-incorrect-vm-switch-information)
5252
- [Refresh the cloud data](#refresh-the-cloud-edgedevices-data)
5353
- [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)
5555

5656
> [!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.
5858
59-
### Remove the lock from the seed node
59+
### Remove the lock from the first machine
6060

61-
Follow these steps to remove the lock from the seed node:
61+
Follow these steps to remove the lock from the first machine:
6262

6363
1. To remove the lock, in the Azure portal, go to the object via the resource group or within Machines - Azure Arc.
6464
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
8383

8484
With the lock removed, follow these steps to remove the validation error.
8585

86-
1. Connect to the seed node. Run the following PowerShell command:
86+
1. Connect to the first machine. Run the following PowerShell command:
8787

8888
```PowerShell
8989
Get-VMSwitch
@@ -143,7 +143,7 @@ After the VM switch on the device is removed, clean up the Edge Device ARM resou
143143
`"switchName": "ConvergedSwitch(managementcompute)",`
144144
`"switchType": "External"`
145145
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 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.
147147
148148
> [!NOTE]
149149
> 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
182182
183183
Follow these steps to refresh the cloud data:
184184
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:
186186
187187
```PowerShell
188188
Restart-Service DeviceManagementService
@@ -211,9 +211,9 @@ Follow these steps in the Azure portal:
211211
212212
1. If no other validation issues occur, start the deployment.
213213
214-
### Recreate the lock on the seed node
214+
### Recreate the lock on the first machine
215215
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.
217217
218218
Follow these steps to recreate the lock:
219219

0 commit comments

Comments
 (0)