Skip to content

Commit 7900b04

Browse files
author
Manika Dhiman
committed
Revert changes to main-config app, docfx, KI
1 parent ebfed56 commit 7900b04

File tree

3 files changed

+37
-19
lines changed

3 files changed

+37
-19
lines changed

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

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use the Configurator app to bootstrap and quickly regi
44
author: alkohli
55
ms.author: alkohli
66
ms.topic: how-to
7-
ms.date: 05/23/2025
7+
ms.date: 05/22/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
---
@@ -28,6 +28,7 @@ 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+
3132
- Note down:
3233

3334
- The serial number for each machine.
@@ -150,7 +151,7 @@ Follow these steps to configure network settings and connect the machines to Azu
150151
151152
1. On the resource group used to bootstrap, you should see your Arc-enabled machines. In this example, you see a single machine.
152153
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":::
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":::
154155
155156
## Troubleshooting
156157
@@ -193,11 +194,11 @@ Here's a table that describes the diagnostic tests:
193194
194195
### Collect a Support log package from the app
195196
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.
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.
197198
198199
#### Download the Support log package
199200
200-
Follow these steps to collect and download a Support log package:
201+
Follow these steps to collect and download a Support package:
201202
202203
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.
203204
@@ -207,25 +208,38 @@ Follow these steps to collect and download a Support log package:
207208
208209
#### Upload the Support log package
209210
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:
211+
>[!IMPORTANT]
212+
> Uploading the Support package to Microsoft can take up to 20 minutes. Make sure to leave the app open and running to complete this process.
215213
214+
Follow these steps to upload the Support package to Microsoft:
216215
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.
217216
218217
:::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":::
219218
220-
1. Provide the required information in the **Upload Support package to Microsoft** dialog:
219+
1. Provide the required information in the **Upload Support package** dialog:
221220
222221
:::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":::
223222
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.
223+
1. The **Cloud type** is populated automatically as `Azure`.
224+
225+
1. Enter a **Subscription ID** to register the machine.
226+
227+
1. Provide a **Resource group** name. This resource group contains the machine and system resources that you create.
228+
229+
1. Specify the **Region** where you want to create the resources. The region should be the same as the region where you want to deploy the Azure Local instance.
230+
231+
> [!IMPORTANT]
232+
> Specify the region with spaces removed. For example, specify the East US region as `EastUS`.
233+
234+
1. Provide a **Tenant ID**. The tenant ID is the directory ID of your Microsoft Entra tenant. To get the tenant ID, see [Find your Microsoft Entra tenant](/azure/azure-portal/get-subscription-tenant-id).
235+
236+
1. If you set up an Azure Arc gateway, specify the Arc gateway ID. This is the resource ID of the Arc gateway that you set up. For more information, see [About Azure Arc gateways](./deployment-azure-arc-gateway-overview.md).
225237
238+
> [!IMPORTANT]
239+
> Make sure to verify all the inputs before you proceed. Any incorrect inputs here might result in an upload failure.
226240
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.
241+
1. Select **Upload** to upload the Support package.
242+
1. Authenticate in the browser with the same account that you used to sign in to the Configurator app. The upload process might take several minutes.
229243
230244
:::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":::
231245
@@ -243,4 +257,4 @@ If you have more than one version of the app installed, when you try to open the
243257
244258
- After your machines are registered with Azure Arc, proceed to deploy your Azure Local system via one of the following options:
245259
- [Deploy via Azure portal](./deploy-via-portal.md).
246-
- [Deploy via ARM template](./deployment-azure-resource-manager-template.md).
260+
- [Deploy via ARM template](./deployment-azure-resource-manager-template.md).

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-24111 || =azloc-previous",
90-
"./*.yml": ">=azloc-24111 || =azloc-previous"
89+
"./*.md": ">=azloc-2411 || =azloc-previous",
90+
"./*.yml": ">=azloc-2411 || =azloc-previous"
9191
}
9292
},
9393
"template": [],
9494
"groups": {
9595
"version-azlocal": {
96-
"moniker_range": ">=azloc-24111 || =azloc-previous",
96+
"moniker_range": ">=azloc-2411 || =azloc-previous",
9797
"dest": "azure-local"
9898
}
9999
}

azure-local/known-issues.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -344,7 +344,7 @@ The following table lists the known issues from previous releases:
344344

345345
::: moniker-end
346346

347-
::: moniker range="=azloc-previous"
347+
::: moniker range="=azloc-2411"
348348

349349
## Known issues for version 2411
350350

@@ -397,6 +397,10 @@ The following table lists the known issues from previous releases:
397397
| Update | When updating the Azure Local instance via the Azure Update Manager, the update progress and results may not be visible in the Azure portal.| To work around this issue, on each node, add the following registry key (no value needed):<br><br>`New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force`</br><br> Then on one of the nodes, restart the Cloud Management cluster group. </br><br>`Stop-ClusterGroup "Cloud Management"`</br><br>`Start-ClusterGroup "Cloud Management"`</br><br> This won't fully remediate the issue as the progress details may still not be displayed for a duration of the update process. To get the latest update details, you can [Retrieve the update progress with PowerShell](./update/update-via-powershell-23h2.md#step-6-track-update-progress). |
398398
| Update <!--26659432--> |In some cases, `SolutionUpdate` commands could fail if run after the `Send-DiagnosticData` command. | Make sure to close the PowerShell session used for `Send-DiagnosticData`. Open a new PowerShell session and use it for `SolutionUpdate` commands.|
399399

400+
::: moniker-end
401+
402+
::: moniker range="=azloc-previous"
403+
400404
## Known issues for version 2408.2
401405

402406
This software release maps to software version number **2408.2.7**.
@@ -1206,4 +1210,4 @@ Here are the known issues from previous releases:
12061210

12071211
## Next steps
12081212

1209-
- Read the [Deployment overview](./deploy/deployment-introduction.md).
1213+
- Read the [Deployment overview](./deploy/deployment-introduction.md).

0 commit comments

Comments
 (0)