Skip to content

Commit fe72bb0

Browse files
authored
Sync release-hotfixes with main
Sync release-hotfixes with main
2 parents 8af2e0e + ebfed56 commit fe72bb0

File tree

9 files changed

+88
-102
lines changed

9 files changed

+88
-102
lines changed

azure-local/deploy/deployment-arc-register-configurator-app.md

Lines changed: 38 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Configurator application for Azure Local (Preview)
3-
description: Learn how to use the Configurator application to bootstrap and Arc register the Azure Local machines. (Preview)
2+
title: Configurator App for Azure Local to Register Machines (Preview)
3+
description: Learn how to use the Configurator app to bootstrap and quickly register your Azure Local machines with Azure Arc. (Preview)
44
author: alkohli
55
ms.author: alkohli
66
ms.topic: how-to
7-
ms.date: 04/30/2025
7+
ms.date: 05/23/2025
88
ms.service: azure-local
99
#CustomerIntent: As an IT Pro, I want to bootstrap and Arc register Azure Local machines via the Arc registration script.
1010
---
@@ -13,7 +13,7 @@ ms.service: azure-local
1313

1414
> Applies to: Azure Local 2502 and later
1515
16-
This article describes how to use the Configurator app to bootstrap and register the machines you plan to include in your Azure Local instance.
16+
This article explains how to use the Configurator app to quickly bootstrap and register machines in your Azure Local instance, enabling seamless Azure Arc integration.
1717

1818
You can use the Configurator app or [Azure CLI](./deployment-arc-register-server-permissions.md) to register your machines. If you plan to deploy a few machines per site, use the Configurator app.
1919

@@ -28,7 +28,6 @@ Before you begin, make sure that you complete the following prerequisites:
2828
[!INCLUDE [hci-registration-azure-local-machine-prerequisites](../includes/hci-registration-azure-local-machine-prerequisites.md)]
2929

3030
- Download the [Configurator App for Azure Local](https://aka.ms/ConfiguratorAppForHCI).
31-
3231
- Note down:
3332

3433
- The serial number for each machine.
@@ -151,7 +150,7 @@ Follow these steps to configure network settings and connect the machines to Azu
151150
152151
1. On the resource group used to bootstrap, you should see your Arc-enabled machines. In this example, you see a single machine.
153152
154-
:::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":::
153+
:::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":::
155154
156155
## Troubleshooting
157156
@@ -166,7 +165,7 @@ You might need to collect logs or diagnose problems if you encounter any issues
166165
167166
If you can't access the app, you can get the logs from a machine. Logs are stored in the following location: `C:\Windows\System32\Bootstrap\Logs`. You can access the logs by connecting to the machine via Remote Desktop Protocol (RDP).
168167
169-
If you can access the app, follow the instructions in [Run diagnostic tests](#run-diagnostic-tests-from-the-app) to troubleshoot the issue and if needed, [Collect a support package](#collect-a-support-package-from-the-app).
168+
If you can access the app, follow the instructions in [Run diagnostic tests](#run-diagnostic-tests-from-the-app) to troubleshoot the issue and if needed, [Collect a support package](#collect-a-support-log-package-from-the-app).
170169
171170
### Run diagnostic tests from the app
172171
@@ -192,16 +191,46 @@ Here's a table that describes the diagnostic tests:
192191
| Azure Arc agent | This test validates the Azure Arc agent is installed and running on the machine. |
193192
| Environment checker | The Environment Checker tool runs a series of tests to evaluate the deployment readiness of your environment for Azure Local deployment including those for connectivity, hardware, Active Directory, network, and Arc integration. For more information, see [Evaluate the deployment readiness of your environment for Azure Local](../manage/use-environment-checker.md#about-the-environment-checker-tool). |
194193
195-
### Collect a Support package from the app
194+
### Collect a Support log package from the app
195+
196+
A Support log package is composed of all the relevant logs that can help Microsoft Support troubleshoot any machine issues. You can generate a Support package via the app.
196197
197-
A Support package is composed of all the relevant logs that can help Microsoft Support troubleshoot any machine issues. You can generate a Support package via the app. Follow these steps to collect a Support package:
198+
#### Download the Support log package
199+
200+
Follow these steps to collect and download a Support log package:
198201
199202
1. Select the help icon in the top-right corner of the app to open the **Support + troubleshooting** pane. Select **Create** to begin support package collection. The package collection could take several minutes.
200203
201204
:::image type="content" source="media/deployment-arc-register-configurator-app/collect-support-package-1.png" alt-text="Screenshot that shows the Support and troubleshooting pane with Create selected." lightbox="media/deployment-arc-register-configurator-app/collect-support-package-1.png":::
202205
203206
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.
204207
208+
#### Upload the Support log package
209+
210+
> [!IMPORTANT]
211+
> - Make sure to run the Configurator app as an administrator to upload the Support log package.
212+
> - Uploading the Support log package to Microsoft can take up to 20 minutes. Make sure to leave the app open and running to complete this process.
213+
214+
Collect a Support log package before you upload it. Follow these steps to upload the Support log package to Microsoft:
215+
216+
1. Select the help icon in the top-right corner of the app to open the **Support + troubleshooting** pane. Select **Upload** to upload the Support package to Microsoft.
217+
218+
:::image type="content" source="media/deployment-arc-register-configurator-app/upload-support-package-1.png" alt-text="Screenshot that shows the Support and troubleshooting pane with Upload package selected." lightbox="media/deployment-arc-register-configurator-app/upload-support-package-1.png":::
219+
220+
1. Provide the required information in the **Upload Support package to Microsoft** dialog:
221+
222+
:::image type="content" source="media/deployment-arc-register-configurator-app/upload-support-package-2.png" alt-text="Screenshot that shows the Upload Support Package dialog filled out." lightbox="media/deployment-arc-register-configurator-app/upload-support-package-2.png":::
223+
224+
The fields in the dialog are prepopulated with the information you provided during [Step 1: Configure the network and connect to Azure](#step-1-configure-the-network-and-connect-to-azure). You can modify the fields as needed.
225+
226+
227+
1. Select **Begin upload** to upload the Support package.
228+
1. Authenticate in the browser with the same account that you used to sign in to register with Azure Arc. The upload process might take several minutes. Leave the app open and running until the upload is complete.
229+
230+
:::image type="content" source="media/deployment-arc-register-configurator-app/upload-support-package-3.png" alt-text="Screenshot that shows the Support and troubleshooting pane with Upload selected and authentication guidance." lightbox="media/deployment-arc-register-configurator-app/upload-support-package-3.png":::
231+
232+
1. After the upload is complete, you receive a confirmation message. You can also view the upload status in the app.
233+
205234
### Clean previous installation
206235
207236
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:
135 KB
Loading
74.9 KB
Loading
146 KB
Loading

azure-local/docfx.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -86,14 +86,14 @@
8686
},
8787
"fileMetadata": {
8888
"monikerRange": {
89-
"./*.md": ">=azloc-2411 || =azloc-previous",
90-
"./*.yml": ">=azloc-2411 || =azloc-previous"
89+
"./*.md": ">=azloc-24111 || =azloc-previous",
90+
"./*.yml": ">=azloc-24111 || =azloc-previous"
9191
}
9292
},
9393
"template": [],
9494
"groups": {
9595
"version-azlocal": {
96-
"moniker_range": ">=azloc-2411 || =azloc-previous",
96+
"moniker_range": ">=azloc-24111 || =azloc-previous",
9797
"dest": "azure-local"
9898
}
9999
}

0 commit comments

Comments
 (0)