Skip to content

Commit 7d9eb84

Browse files
Merge pull request #4371 from MicrosoftDocs/main639193178051101041sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents c984311 + cfb9e98 commit 7d9eb84

9 files changed

Lines changed: 24 additions & 16 deletions

azure-managed-lustre/client-upgrade.md

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ author: jeffbearer
66
ms.author: jebearer
77
ms.reviewer: wdesalvador
88
ms.date: 06/19/2026
9+
zone_pivot_groups: select-os
910

1011
---
1112

@@ -27,7 +28,7 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
2728
> - **Kernel upgrades** (for example, 5.15.0-100 → 5.15.0-105): If you installed the Lustre client by using DKMS, kernel upgrades are handled automatically. DKMS recompiles the Lustre module during the kernel package install (typically 2-5 minutes), not at boot. The new kernel is ready to load Lustre as soon as you reboot. **No action is needed** - you don't need to follow this procedure.
2829
> - **Lustre version upgrades** (for example, 2.15.7 → 2.15.8): To upgrade to a newer Lustre release, follow the steps in this article. The procedure is the same for both kmod and DKMS users - uninstall the old version, then install the new one.
2930
30-
### [Red Hat Enterprise Linux / Alma](#tab/rhel)
31+
::: zone pivot="rhel-9,rhel-8,rhel-7,alma-86"
3132

3233
1. Unmount any containers or mount points that are mounting the Lustre client by using the following command:
3334

@@ -73,7 +74,9 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
7374

7475
If the output shows an old version of the Lustre kernel module, we recommend that you restart (`sudo reboot`) the system.
7576

76-
### [Ubuntu 20.04/22.04](#tab/ubuntu)
77+
::: zone-end
78+
79+
::: zone pivot="ubuntu-22,ubuntu-20,ubuntu-18"
7780

7881
1. Unmount any containers or mount points that are mounting the Lustre client by using the following command:
7982

@@ -119,7 +122,9 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
119122

120123
If the output shows an old version of the Lustre kernel module, we recommend that you restart (`sudo reboot`) the system.
121124

122-
### [Ubuntu 24.04](#tab/ubuntu24)
125+
::: zone-end
126+
127+
::: zone pivot="ubuntu-24"
123128

124129
1. Unmount any containers or mount points that are mounting the Lustre client by using the following command:
125130

@@ -165,7 +170,9 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
165170

166171
If the output shows an old version of the Lustre kernel module, we recommend that you restart (`sudo reboot`) the system.
167172

168-
### [Azure Linux 3](#tab/azurelinux3)
173+
::: zone-end
174+
175+
::: zone pivot="azurelinux-3"
169176

170177
1. Unmount any containers or mount points that are mounting the Lustre client by using the following command:
171178

@@ -204,8 +211,9 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
204211
sleep 5; cat /sys/module/lustre/version; lsmod | grep -E 'lustre|lnet'
205212
```
206213

207-
The output should show the new Lustre version (for example, `2.17.0_19_gbb5310f`).
208-
---
214+
The output should show the new Lustre version (for example, `2.17.0_24_gf517bc4`).
215+
216+
::: zone-end
209217

210218
After you perform this procedure, you can [mount the client](connect-clients.md#start-the-lustre-client-by-using-the-mount-command) to your Azure Managed Lustre file system.
211219

azure-managed-lustre/includes/client-install-dkms-azurelinux-3.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.lastreviewed: 04/23/2026
99
---
1010

1111
```bash
12-
sudo tdnf install -y lustre-client-dkms-2.17.0_19_gbb5310f
12+
sudo tdnf install -y lustre-client-dkms-2.17.0_24_gf517bc4
1313
```
1414

1515
This DKMS package automatically includes the matching Lustre userspace tools package (`lustre-client`) as a dependency. So, a single `tdnf install` command gives you both the module source and the userspace tools.

azure-managed-lustre/includes/client-install-dkms-ubuntu-24.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.lastreviewed: 04/23/2026
1212
> 2.17 is a non-LTS release of Lustre. Community support ends soon after the 2.18 release.
1313
1414
```bash
15-
sudo apt install -y amlfs-lustre-client-dkms-2.17.0-19-gbb5310f
15+
sudo apt install -y amlfs-lustre-client-dkms-2.17.0-24-gf517bc4
1616
```
1717

1818
This metapackage installs the Lustre userspace tools (`lustre-client`) together with the DKMS module source package (`lustre-client-modules-dkms`), so they stay at matching versions.

azure-managed-lustre/includes/client-install-version-azurelinux-3.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.lastreviewed:
99
---
1010

1111
```bash
12-
sudo tdnf install -y amlfs-lustre-client-2.17.0_19_gbb5310f-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
12+
sudo tdnf install -y amlfs-lustre-client-2.17.0_24_gf517bc4-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
1313
```
1414

1515
> [!NOTE]
@@ -34,5 +34,5 @@ sudo reboot
3434
After the reboot, install the Lustre client for your new kernel:
3535

3636
```bash
37-
sudo tdnf install -y amlfs-lustre-client-2.17.0_19_gbb5310f-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
37+
sudo tdnf install -y amlfs-lustre-client-2.17.0_24_gf517bc4-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
3838
```

azure-managed-lustre/includes/client-install-version-ubuntu-24.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.reviewer: wdesalvador
1111
> Version 2.17 is a non-LTS release of Lustre and the community support ends soon after the release of version 2.18. For more information about the 2.18 release, check back later.
1212
1313
```bash
14-
sudo apt install amlfs-lustre-client-2.17.0-19-gbb5310f=$(uname -r)
14+
sudo apt install amlfs-lustre-client-2.17.0-24-gf517bc4=$(uname -r)
1515
```
1616

1717
> [!NOTE]
@@ -20,5 +20,5 @@ sudo apt install amlfs-lustre-client-2.17.0-19-gbb5310f=$(uname -r)
2020
Optionally, if you want to upgrade *only* the kernel and not all packages, you must (at minimum) also upgrade the `amlfs-lustre-client` metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
2121

2222
```bash
23-
apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.17.0-19-gbb5310f
23+
apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.17.0-24-gf517bc4
2424
```

azure-managed-lustre/includes/client-upgrade-dkms-azurelinux-3.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,5 @@ ms.lastreviewed: 04/23/2026
99
---
1010

1111
```bash
12-
sudo tdnf install -y lustre-client-dkms-2.17.0_19_gbb5310f
12+
sudo tdnf install -y lustre-client-dkms-2.17.0_24_gf517bc4
1313
```

azure-managed-lustre/includes/client-upgrade-dkms-ubuntu-24.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,5 @@ ms.lastreviewed: 04/23/2026
99
---
1010

1111
```bash
12-
sudo apt install -y amlfs-lustre-client-dkms-2.17.0-19-gbb5310f
12+
sudo apt install -y amlfs-lustre-client-dkms-2.17.0-24-gf517bc4
1313
```

azure-managed-lustre/includes/client-upgrade-version-azurelinux-3.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,5 @@ ms.lastreviewed:
99
---
1010

1111
```bash
12-
sudo tdnf install -y amlfs-lustre-client-2.17.0_19_gbb5310f-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
12+
sudo tdnf install -y amlfs-lustre-client-2.17.0_24_gf517bc4-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
1313
```

azure-managed-lustre/includes/client-upgrade-version-ubuntu-24.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,5 @@ ms.reviewer: wdesalvador
88
---
99

1010
```bash
11-
sudo apt install -y amlfs-lustre-client-2.17.0-19-gbb5310f=$(uname -r)
11+
sudo apt install -y amlfs-lustre-client-2.17.0-24-gf517bc4=$(uname -r)
1212
```

0 commit comments

Comments
 (0)