Skip to content

Commit b849c1a

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/MicrosoftDocs/azure-stack-docs-pr (branch live)
2 parents e5535fa + 6eb2e84 commit b849c1a

File tree

9 files changed

+77
-31
lines changed

9 files changed

+77
-31
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
}

azure-local/known-issues.md

Lines changed: 1 addition & 5 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-2411"
347+
::: moniker range="=azloc-previous"
348348

349349
## Known issues for version 2411
350350

@@ -397,10 +397,6 @@ 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-
404400
## Known issues for version 2408.2
405401

406402
This software release maps to software version number **2408.2.7**.

azure-local/manage/add-server.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Manage capacity by adding a node on Azure Local, version 23H2
2+
title: Manage Capacity by Adding a Node on Azure Local, Version 23H2
33
description: Learn how to manage capacity on your Azure Local, version 23H2 system by adding a node.
44
ms.topic: article
55
author: alkohli
66
ms.author: alkohli
7-
ms.date: 05/08/2025
7+
ms.date: 05/22/2025
88
---
99

1010
# Add a node on Azure Local

azure-local/security-update/security-update.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Security updates for Azure Local, version 23H2
33
description: Security updates for Azure Local, version 23H2.
44
author: alkohli
55
ms.topic: conceptual
6-
ms.date: 04/25/2025
6+
ms.date: 05/12/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
---
@@ -306,7 +306,7 @@ For a list of the files that are provided in this update, download the file info
306306
307307
::: moniker-end
308308
309-
::: moniker range="azloc-2411"
309+
::: moniker range="azloc-previous"
310310
311311
## November OS security update (KB) for Azure Local
312312
@@ -344,10 +344,6 @@ To install the LCU on your Azure Local instance, see [Update Azure Stack Local i
344344
345345
For a list of the files that are provided in this update, download the file information for [Cumulative update KB 5046618](https://go.microsoft.com/fwlink/?linkid=2296832).
346346
347-
::: moniker-end
348-
349-
::: moniker range="azloc-previous"
350-
351347
## October OS security update (KB 5044288) for Azure Local
352348
353349
<!-- [!INCLUDE [applies-to](../includes/hci-applies-to-23h2.md)] -->

azure-local/whats-new.md

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.topic: overview
55
author: alkohli
66
ms.author: alkohli
77
ms.service: azure-local
8-
ms.date: 05/08/2025
8+
ms.date: 05/22/2025
99
---
1010

1111
# What's new in Azure Local?
@@ -16,6 +16,35 @@ ms.date: 05/08/2025
1616

1717
This article lists the various features and improvements that are available in Azure Local. The latest version of Azure Local solution focuses on cloud-based deployment and updates, cloud-based monitoring, new and simplified experience for Azure Local virtual machine (VM) management, security, and more.
1818

19+
::: moniker range="=azloc-2505"
20+
21+
There are two 2505 releases for May. Here are the details of each release:
22+
23+
|Solution version |OS version |Deployment |
24+
|---------|---------|---------|
25+
|12.2505.1001.23 | 26100.4061 | New deployments only. |
26+
|11.2505.1001.22 | 25398.1611 | Existing deployments only. |
27+
28+
For more information, see [Release information summary](./release-information-23h2.md).
29+
30+
## Features and improvements in 2505
31+
32+
This release has the following features and improvements:
33+
34+
- **OS version changes**:
35+
36+
- In the last release (2504), a new operating system was introduced for Azure Local deployments. For 2505, all the new deployments of Azure Local will run OS version **26100.4061**. You can download the 2505 OS image from the Azure portal. You also need to get the driver compatible with Azure Local 12.2505 or Windows Server 2025. If a compatible driver is not available, you can use the 2503 image.
37+
38+
Existing deployments of Azure Local will continue to use OS version **25398.1611**. For more information, see [Release information summary](./release-information-23h2.md).
39+
40+
- If you've purchased Integrated System or Premier solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner, the OS should be preinstalled. Work with your Original Equipment Manufacturer (OEM) to get the OS image compatible with **12.2505** and driver compatible with Azure Local 12.2505 or Windows Server 2025.
41+
42+
- **.NET updates**: This build uses .NET version **8.0.16** for both .NET Runtime and ASP.NET Core. For more details, see [Download .NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0).
43+
44+
- **Update changes**: This release includes reliability improvements to the update process. For more information, see [Fixed issues in 2505](./known-issues.md?view=azloc-2505&preserve-view=true#fixed-issues).
45+
46+
::: moniker-end
47+
1948
::: moniker range="=azloc-2504"
2049

2150
Starting with 2504 release, Microsoft introduced a new versioning schema. There are two 2504 releases for April. Here are the details of each release:
@@ -170,7 +199,7 @@ For more information on improvements in this release, see the [Fixed issues in 2
170199

171200
::: moniker-end
172201

173-
::: moniker range="=azloc-2411"
202+
::: moniker range="=azloc-previous"
174203

175204
## Features and improvements in 2411
176205

@@ -219,10 +248,6 @@ This release has the following features and improvements:
219248

220249
- **AKS on Azure Local** - This release has several new features and enhancements for AKS on Azure Local. For more information, see [What's new in AKS on Azure Local](/azure/aks/hybrid/aks-whats-new-23h2).
221250

222-
::: moniker-end
223-
224-
::: moniker range="=azloc-previous"
225-
226251
## Features and improvements in 2408.2
227252

228253
This release has the following features and improvements:

0 commit comments

Comments
 (0)