Skip to content

Commit 9510d2d

Browse files
Merge pull request #3627 from MicrosoftDocs/main638816296391944166sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 012e35d + 138202c commit 9510d2d

12 files changed

+197
-46
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1316,6 +1316,11 @@
13161316
"redirect_url": "/azure/azure-managed-lustre/client-install?pivots=ubuntu-22",
13171317
"redirect_document_id": false
13181318
},
1319+
{
1320+
"source_path": "azure-managed-lustre/install-ubuntu-24.md",
1321+
"redirect_url": "/azure/azure-managed-lustre/client-install?pivots=ubuntu-24",
1322+
"redirect_document_id": false
1323+
},
13191324
{
13201325
"source_path": "azure-stack/hci/get-started.md",
13211326
"redirect_url": "/azure-stack/hci/manage/monitor-cluster",

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use the Configurator application to bootstrap and Arc
44
author: alkohli
55
ms.author: alkohli
66
ms.topic: how-to
7-
ms.date: 03/20/2025
7+
ms.date: 04/30/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
---
@@ -95,7 +95,7 @@ Follow these steps to configure network settings and connect the machines to Azu
9595
9696
1. Select **ON** to enable **Remote desktop** protocol. Remote desktop protocol is disabled by default.
9797
98-
1. Select **Public endpoint** or **Proxy server** as the connectivity method. If selecting a proxy server, provide the proxy URL and the bypass list.
98+
1. Select **Public endpoint** or **Proxy server** as the connectivity method. If selecting a proxy server, provide the proxy URL and the bypass list. The bypass list is required and can be provided in a comma separated format.
9999
100100
1. Select a time zone.
101101

azure-local/includes/hci-registration-azure-prerequisites.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ author: alkohli
33
ms.author: alkohli
44
ms.service: azure-local
55
ms.topic: include
6-
ms.date: 04/16/2025
6+
ms.date: 04/30/2025
77
ms.reviewer: alkohli
88
ms.lastreviewed: 03/20/2025
99
---
@@ -14,16 +14,16 @@ ms.lastreviewed: 03/20/2025
1414
Run the following [PowerShell commands](/azure/azure-resource-manager/management/resource-providers-and-types#azure-powershell) to register:
1515

1616
```powershell
17-
Register-ResourceProvider -ProviderNamespace "Microsoft.HybridCompute"
18-
Register-ResourceProvider -ProviderNamespace "Microsoft.GuestConfiguration"
19-
Register-ResourceProvider -ProviderNamespace "Microsoft.HybridConnectivity"
20-
Register-ResourceProvider -ProviderNamespace "Microsoft.AzureStackHCI"
21-
Register-ResourceProvider -ProviderNamespace "Microsoft.Kubernetes"
22-
Register-ResourceProvider -ProviderNamespace "Microsoft.KubernetesConfiguration"
23-
Register-ResourceProvider -ProviderNamespace "Microsoft.ExtendedLocation"
24-
Register-ResourceProvider -ProviderNamespace "Microsoft.ResourceConnector"
25-
Register-ResourceProvider -ProviderNamespace "Microsoft.HybridContainerService"
26-
Register-ResourceProvider -ProviderNamespace "Microsoft.Attestation"
17+
Register-AzResourceProvider -ProviderNamespace "Microsoft.HybridCompute"
18+
Register-AzResourceProvider -ProviderNamespace "Microsoft.GuestConfiguration"
19+
Register-AzResourceProvider -ProviderNamespace "Microsoft.HybridConnectivity"
20+
Register-AzResourceProvider -ProviderNamespace "Microsoft.AzureStackHCI"
21+
Register-AzResourceProvider -ProviderNamespace "Microsoft.Kubernetes"
22+
Register-AzResourceProvider -ProviderNamespace "Microsoft.KubernetesConfiguration"
23+
Register-AzResourceProvider -ProviderNamespace "Microsoft.ExtendedLocation"
24+
Register-AzResourceProvider -ProviderNamespace "Microsoft.ResourceConnector"
25+
Register-AzResourceProvider -ProviderNamespace "Microsoft.HybridContainerService"
26+
Register-AzResourceProvider -ProviderNamespace "Microsoft.Attestation"
2727
```
2828

2929
> [!NOTE]

azure-local/manage/gpu-manage-via-partitioning.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: alkohli
55
ms.author: alkohli
66
ms.topic: how-to
77
ms.service: azure-local
8-
ms.date: 03/26/2025
8+
ms.date: 04/29/2025
99
---
1010

1111
# Manage GPUs using partitioning (preview)
@@ -33,7 +33,7 @@ Consider the following limitations when using the GPU-P feature:
3333

3434
- Partitions are autoassigned to the VMs. You can't choose a specific partition for a specific VM.
3535

36-
- Currently, GPU partitioning on Azure Local doesn't support live migration of VMs. But VMs can be automatically restarted and placed where GPU resources are available if there's a failure.
36+
- GPU partitioning on Azure Local supports live migration. However, the host and VMs must be on NVIDIA virtual GPU software version 18 and later. For more information, see [Microsoft Azure Local - NVIDIA Docs](https://docs.nvidia.com/vgpu/18.0/grid-vgpu-release-notes-microsoft-azure-stack-hci/index.html).
3737

3838
- You can partition your GPU using Azure Command-Line Interface (CLI). We recommend that you use Azure CLI to configure and assign GPU partitions. You must manually ensure that the homogeneous configuration is maintained for GPUs across all the machines in your system.
3939

@@ -43,7 +43,7 @@ Consider the following limitations when using the GPU-P feature:
4343

4444
## Attach a GPU during Azure Local VM creation
4545

46-
Follow the steps outlined in [Create Azure Local virtual machines](create-arc-virtual-machines.md?tabs=azurecli) and utilize the additional hardware profile details to add GPU to your create process. Run the following:
46+
Follow the steps outlined in [Create Azure Local virtual machines](create-arc-virtual-machines.md?tabs=azurecli) and utilize the extra hardware profile details to add GPU to your create process. Run the following:
4747

4848
```azurecli
4949
az stack-hci-vm create --name $vmName --resource-group $resource_group --admin-username $userName --admin-password $password --computer-name $computerName --image $imageName --location $location --authentication-type all --nics $nicName --custom-location $customLocationID --hardware-profile memory-mb="8192" processors="4" --storage-path-id $storagePathId --gpus GpuP
@@ -65,7 +65,7 @@ You can specify the partition size in the command, as shown below. Partition siz
6565
az stack-hci-vm gpu attach --resource-group "test-rg" --custom-location "test-location" --vm-name "test-vm" --gpus GpuP
6666
```
6767

68-
After attaching the GPU partition, the output will show the full VM details. You can confirm the GPUs were attached by reviewing the hardware profile `virtualMachineGPUs` section. The output will look as follows:
68+
After attaching the GPU partition, the output shows the full VM details. You can confirm the GPUs were attached by reviewing the hardware profile `virtualMachineGPUs` section. The output looks as follows:
6969

7070
```azurecli
7171
"properties":{
@@ -89,7 +89,7 @@ Use the following CLI command to detach the GPU:
8989
az stack-hci-vm gpu detach --resource-group "test-rg" --custom-location "test-location" --vm-name "test-vm" --gpus GpuP
9090
```
9191

92-
After detaching the GPU partition, the output will show the full VM details. You can confirm the GPUs were detached by reviewing the hardware profile `virtualMachineGPUs`. The output will look as follows:
92+
After detaching the GPU partition, the output shows the full VM details. You can confirm the GPUs were detached by reviewing the hardware profile `virtualMachineGPUs`. The output looks as follows:
9393

9494
```azurecli
9595
"properties":{

azure-local/release-information-23h2.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Follow these guidelines to update to each release within your current release tr
5555
|--------------------------------------|-------------------|
5656
| Nov 2024 | 2411 --> 2411.1 |
5757
| December 2024 or later | 2411.1 --> 2411.2 |
58-
| February 2024 | 2411.2 --> 2411.3 |
58+
| February 2025 | 2411.2 --> 2411.3 |
5959

6060
- To keep your Azure Local instance in a supported state, you have up to six months to install updates. For example, if you're running the 2408 feature build, update to a later build within six months.
6161

@@ -83,7 +83,7 @@ Starting in 2504, we offer two releases. One release provides the path to upgrad
8383

8484
|Version| OS Build |Security update| What's new | Known issues |
8585
|------|-------|---------------|------------|--------------|
86-
| 12.2504.1001.20 <br><br> Availability date: 2025-04-23 | 26100.3775 | [April OS security update](security-update/security-update.md?view=azloc-2504&preserve-view=true) | [Features and improvements](./whats-new.md?view=azloc-2504&preserve-view=true#features-and-improvements-in-2504) | [Known issues](./known-issues.md?view=azloc-2504&preserve-view=true) |
86+
| 12.2504.1001.20 <br><br> Availability date: 2025-04-29 | 26100.3775 | [April OS security update](security-update/security-update.md?view=azloc-2504&preserve-view=true) | [Features and improvements](./whats-new.md?view=azloc-2504&preserve-view=true#features-and-improvements-in-2504) | [Known issues](./known-issues.md?view=azloc-2504&preserve-view=true) |
8787

8888
---
8989

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

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,10 @@ This article describes the OS security updates for Azure Local that were release
2020

2121
For the 2504 release of Azure Local, Microsoft released two security updates: one for existing deployments and another for new deployments. The following table provides information about different deployment types, their corresponding security updates, and OS builds:
2222

23-
2423
| Deployment type | Security update | OS build | Release date |
2524
|---------|---------|---------|---------|
2625
| Existing deployments | KB5055527 | 25398.1551 | April 12, 2025 |
27-
| New deployments | KB5055523 | 26100.3775 | April 30, 2025 |
28-
26+
| New deployments | KB5055523 | 26100.3775 | April 12, 2025 |
2927

3028
# [Existing deployments](#tab/existing-deployments)
3129

azure-local/whats-new.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,19 +40,21 @@ This release has the following features and improvements:
4040
- **Registration and deployment changes**:
4141
- Starting with this release, you can download a specific version of Azure Local software instead of just the latest version. For each upcoming release, you can choose from up to last six supported versions. For more information, see [Download Azure Local software](./deploy/download-23h2-software.md).
4242
- The error logging in the registration script is enhanced.
43+
- Proxy bypass list is now mandatory if a proxy configuration is specified.
4344

4445
- **Security changes**: The Dynamic Root of Trust for Measurement (DRTM) is enabled by default for all new 2504 deployments running OS version **21600.3775**. For more information, see [Security features for Azure Local](./concepts/security-features.md#security-features-for-azure-local).
4546

4647
- **Azure Local VM changes**:
4748
- **Data disk expansion**: With this release, you can expand the size of a data disk attached to an Azure Local VM. For more information, see [Expand the size of a data disk attached to an Azure Local VM](./manage/manage-arc-virtual-machine-resources.md).
49+
- **Live VM migration with GPU partitioning (GPU-P)**: You can now live migrate VMs with GPU-P. These VMs must be on the latest NVIDIA virtual GPU v18 drivers to enable live migration with GPU-P. For more information, see [Microsoft Azure Local - NVIDIA Docs](https://docs.nvidia.com/vgpu/18.0/grid-vgpu-release-notes-microsoft-azure-stack-hci/index.html).
4850
- **Documentation changes**: An article describing a [Comparison of the management capabilities of VMs on Azure](./concepts/compare-vm-management-capabilities.md) was released recently.
4951

5052
- **Update improvements**:
5153
- Improved reliability when downloading updates.
5254
- Added a health check to ensure failover cluster nodes are healthy before starting the update.
5355
- Simplified the Azure portal experience for viewing the progress and history of update runs.
5456

55-
-**Add and repair node changes**:
57+
- **Add and repair node changes**:
5658
- For Microsoft images, download the OS image matching the solution version of your existing cluster. See the [Release table](https://github.com/Azure-Samples/AzureLocal/blob/main/os-image/os-image-tracking-table.md) for the correct version. For OEM images, contact your Original Equipment Manufacturer (OEM).
5759

5860
- **OEM license changes**:
@@ -69,6 +71,8 @@ This release has the following features and improvements:
6971

7072
- **Archival of Azure Local, version 22H2 documentation**: The documentation for version 22H2 will be archived by May 31, 2025 and will be available in the [Azure previous versions documentation](/previous-versions/azure/) for reference. The archived documentation isn't updated and isn't supported.
7173

74+
- **Observability changes**: You can now automatically collect, analyze, and debug Azure services crashes with the crash dump collection feature in Azure Local. For more information, see [Crash dump collection](./concepts/observability.md#crash-dump-collection).
75+
7276
::: moniker-end
7377

7478
::: moniker range="=azloc-2503"

azure-managed-lustre/client-install.md

Lines changed: 89 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.topic: how-to
55
author: pauljewellmsft
66
ms.author: pauljewell
77
ms.reviewer: dsundarraj
8-
ms.date: 01/10/2025
8+
ms.date: 04/29/2025
99
zone_pivot_groups: select-os
1010

1111
---
@@ -89,11 +89,11 @@ This article shows how to install the client package to set up client VMs runnin
8989
```bash
9090
#!/bin/bash
9191
set -ex
92-
92+
9393
rpm --import https://packages.microsoft.com/keys/microsoft.asc
94-
94+
9595
DISTRIB_CODENAME=el8
96-
96+
9797
REPO_PATH=/etc/yum.repos.d/amlfs.repo
9898
echo -e "[amlfs]" > ${REPO_PATH}
9999
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
@@ -125,11 +125,11 @@ This article shows how to install the client package to set up client VMs runnin
125125
```bash
126126
#!/bin/bash
127127
set -ex
128-
128+
129129
rpm --import https://packages.microsoft.com/keys/microsoft.asc
130-
130+
131131
DISTRIB_CODENAME=el7
132-
132+
133133
REPO_PATH=/etc/yum.repos.d/amlfs.repo
134134
echo -e "[amlfs]" > ${REPO_PATH}
135135
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
@@ -160,11 +160,11 @@ This article shows how to install the client package to set up client VMs runnin
160160
```bash
161161
#!/bin/bash
162162
set -ex
163-
163+
164164
rpm --import https://packages.microsoft.com/keys/microsoft.asc
165-
165+
166166
DISTRIB_CODENAME=el8
167-
167+
168168
REPO_PATH=/etc/yum.repos.d/amlfs.repo
169169
echo -e "[amlfs]" > ${REPO_PATH}
170170
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
@@ -195,11 +195,11 @@ This article shows how to install the client package to set up client VMs runnin
195195
```bash
196196
#!/bin/bash
197197
set -ex
198-
198+
199199
rpm --import https://packages.microsoft.com/keys/microsoft.asc
200-
200+
201201
DISTRIB_CODENAME=el9
202-
202+
203203
REPO_PATH=/etc/yum.repos.d/amlfs.repo
204204
echo -e "[amlfs]" > ${REPO_PATH}
205205
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
@@ -241,12 +241,12 @@ This article shows how to install the client package to set up client VMs runnin
241241
```bash
242242
#!/bin/bash
243243
set -ex
244-
244+
245245
apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
246246
source /etc/lsb-release
247247
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
248248
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
249-
249+
250250
apt update
251251
```
252252

@@ -271,12 +271,12 @@ This article shows how to install the client package to set up client VMs runnin
271271
```bash
272272
#!/bin/bash
273273
set -ex
274-
274+
275275
apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
276276
source /etc/lsb-release
277277
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
278278
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
279-
279+
280280
apt update
281281
```
282282

@@ -322,7 +322,7 @@ This article shows how to install the client package to set up client VMs runnin
322322
1. Remove any kernels newer than the one mentioned in the LTS metapackage.
323323

324324
```bash
325-
sudo apt remove linux-image-5.15.0-1053-azure
325+
sudo apt remove linux-image-6.8.0-1027-azure
326326
```
327327

328328
You receive a warning about removing the kernels, but these steps work if you're following them on a newly provisioned host. If you have concerns, consult Ubuntu documentation on configuring kernels to ensure that they can start after a restart.
@@ -340,12 +340,12 @@ This article shows how to install the client package to set up client VMs runnin
340340
```bash
341341
#!/bin/bash
342342
set -ex
343-
343+
344344
apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
345345
source /etc/lsb-release
346346
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
347347
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
348-
348+
349349
apt update
350350
```
351351

@@ -363,6 +363,75 @@ This article shows how to install the client package to set up client VMs runnin
363363

364364
::: zone-end
365365

366+
::: zone pivot="ubuntu-24"
367+
368+
> [!IMPORTANT]
369+
> The Azure Marketplace image for the Ubuntu 24.04 LTS release uses the Hardware Enablement (HWE) kernel by default. However, HWE kernels are supported only for six-month periods, and Lustre support for these kernels is often not available when they're released. We recommend that you switch to the LTS kernel because it gives you more stability and it maintains a kernel version that's supported with the Lustre client.
370+
371+
1. Install the LTS kernel metapackage:
372+
373+
```bash
374+
sudo apt update && sudo apt install linux-image-azure-lts-24.04
375+
```
376+
377+
1. Remove the default (HWE) kernel metapackage. The response to the following command also asks you to remove the `linux-azure` metapackage.
378+
379+
```bash
380+
sudo apt remove linux-image-azure
381+
```
382+
383+
1. List installed kernels and see which one the LTS metapackage supplies:
384+
385+
```bash
386+
apt list --installed linux-image*
387+
```
388+
389+
Newly provisioned hosts have two kernels, and older hosts might have more. Compare the version that the LTS metapackage provides against the other installed kernels.
390+
391+
1. Remove any kernels newer than the one mentioned in the LTS metapackage.
392+
393+
```bash
394+
sudo apt remove linux-image-6.11.0-1013-azure
395+
```
396+
397+
You receive a warning about removing the kernels, but these steps work if you're following them on a newly provisioned host. If you have concerns, consult Ubuntu documentation on configuring kernels to ensure that they can start after a restart.
398+
399+
1. List installed kernels again to verify that you don't have kernels newer than the one mentioned in the LTS metapackage:
400+
401+
```bash
402+
apt list --installed linux-image*
403+
```
404+
405+
1. Restart to load the LTS kernel.
406+
407+
1. Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it `repo.bash`:
408+
409+
```bash
410+
#!/bin/bash
411+
set -ex
412+
413+
apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
414+
source /etc/lsb-release
415+
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
416+
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
417+
418+
apt update
419+
```
420+
421+
1. Run the script as a superuser:
422+
423+
```bash
424+
sudo bash repo.bash
425+
```
426+
427+
1. Install the metapackage that matches your running kernel.
428+
429+
The following command installs a metapackage that keeps the version of Lustre aligned with the installed kernel. For this alignment to work, you must use `apt full-upgrade` instead of `apt upgrade` when updating your system.
430+
431+
[!INCLUDE [client-install-version-ubunt-24](./includes/client-install-version-ubuntu-24.md)]
432+
433+
::: zone-end
434+
366435
## Related content
367436

368437
- [Connect clients to an Azure Managed Lustre file system](connect-clients.md)

0 commit comments

Comments
 (0)