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/deploy/deployment-arc-register-configurator-app.md
+16-5Lines changed: 16 additions & 5 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 use the Configurator application to bootstrap and Arc
4
4
author: alkohli
5
5
ms.author: alkohli
6
6
ms.topic: how-to
7
-
ms.date: 02/12/2025
7
+
ms.date: 02/20/2025
8
8
ms.service: azure-local
9
9
#CustomerIntent: As an IT Pro, I want to bootstrap and Arc register Azure Local machines via the Arc registration script.
10
10
---
@@ -113,7 +113,7 @@ Follow these steps to configure network settings and connect the machines to Azu
113
113
114
114
:::image type="content" source="media/deployment-arc-register-configurator-app/prerequisites-1.png" alt-text="Screenshot of the Prerequisites tab in the Configurator app for Azure Local when all the prerequisites are met." lightbox="media/deployment-arc-register-configurator-app/prerequisites-1.png":::
115
115
116
-
If a requirement isn't met, the app displays a warning icon. Resolve the issue before you proceed. For more information, see [Troubleshooting](#troubleshooting).
116
+
If a requirement isn't met, the app displays a warning or errors. Resolve the issue before you proceed. For more information, see [Troubleshooting](#troubleshooting).
117
117
118
118
:::image type="content" source="media/deployment-arc-register-configurator-app/prerequisites-2.png" alt-text="Screenshot of the Prerequisites tab in the Configurator app for Azure Local when one of the prerequisites isn't met." lightbox="media/deployment-arc-register-configurator-app/prerequisites-2.png":::
119
119
@@ -180,17 +180,19 @@ Follow these steps to configure network settings and connect the machines to Azu
180
180
181
181
1. During the Arc registration process, you must authenticate with your Azure account. The app displays a code that you must enter in the URL, displayed in the app, in order to authenticate. Follow the instructions to complete the authentication process.
182
182
183
-
<!--:::image type="content" source="media/deployment-arc-register-configurator-app/arc-agent-registration-6.png" alt-text="Screenshot of the Arc agent sign in and registration dialog in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/arc-agent-registration-6.png":::-->
183
+
:::image type="content" source="media/deployment-arc-register-configurator-app/setup-configuration-authentication.png" alt-text="Screenshot of the Arc agent sign in and registration dialog in the Configurator app for Azure Local." lightbox="media/deployment-arc-register-configurator-app/setup-configuration-authentication.png":::
184
184
185
185
1. Once the configuration is complete, status for Arc configuration should display **Success (Open in Azure portal)**.
186
186
187
187
1. Repeat all steps on the other machines until the Arc configuration succeeds. Select the **Open in Azure portal** link.
188
188
189
189
## Step 3: Verify machines are connected to Arc
190
190
191
-
1. In the Azure portal, go to the resource group for bootstrapping.
191
+
1. In the Azure portal, go to the resource group that you used for bootstrapping.
192
192
193
-
1. On the resource group used to bootstrap, you should see your Arc-enabled machines. <!--In this example, you see a single machine.-->
193
+
1. On the resource group used to bootstrap, you should see your Arc-enabled machines. In this example, you see a single machine.
194
+
195
+
:::image type="content" source="media/deployment-arc-register-configurator-app/setup-arc-enabled-servers.png" alt-text="Screenshot that shows the Azure Arc agent Arc-enabled servers in Azure portal for Azure Local ." lightbox="media/deployment-arc-register-configurator-app/setup-arc-enabled-servers.png":::
194
196
195
197
## Troubleshooting
196
198
@@ -199,6 +201,7 @@ You might need to collect logs or diagnose problems if you encounter any issues
199
201
- Get logs from a machine.
200
202
- Run diagnostic tests.
201
203
- Collect a Support package.
204
+
- Clean previous installation.
202
205
203
206
### Get logs if the app is inaccessible
204
207
@@ -240,6 +243,14 @@ A Support package is composed of all the relevant logs that can help Microsoft S
240
243
241
244
1. After the Support package is created, select **Download**. This action downloads two zipped packages corresponding to Support logs and Configurator logs on your local system. You can unzip the package and view the system log files.
242
245
246
+
### Clean previous installation
247
+
248
+
If you have more than one version of the app installed, when you try to open the app, an older version of the app might open. To fix this issue, clean the previous installation. Follow these steps to clean the previous installation:
249
+
250
+
1. Uninstall the Configurator app as you would any other app on the system.
251
+
1. Delete the `C:\Users\%USERNAME%\AppData\Roaming\microsoft.-azure.-edge.-oobe.-local-ui` directory.
252
+
1. Launch the app again. The app should open without any issues.
253
+
243
254
## Next steps
244
255
245
256
- After your machines are registered with Azure Arc, proceed to deploy your Azure Local system via one of the following options:
0 commit comments