Merge pull request #17786 from t-mialve/t-mialve/u24-install

Add Ubuntu 24.04 install instructions

Author: JamesJBarnett

.openpublishing.redirection.json

@@ -1316,6 +1316,11 @@
       "redirect_url": "/azure/azure-managed-lustre/client-install?pivots=ubuntu-22",
       "redirect_document_id": false
     },
+    {
+      "source_path": "azure-managed-lustre/install-ubuntu-24.md",
+      "redirect_url": "/azure/azure-managed-lustre/client-install?pivots=ubuntu-24",
+      "redirect_document_id": false
+    },
     {
       "source_path": "azure-stack/hci/get-started.md",
       "redirect_url": "/azure-stack/hci/manage/monitor-cluster",

azure-managed-lustre/client-install.md

@@ -5,7 +5,7 @@ ms.topic: how-to
 author: pauljewellmsft
 ms.author: pauljewell
 ms.reviewer: dsundarraj
-ms.date: 01/10/2025
+ms.date: 04/29/2025
 zone_pivot_groups: select-os
 
 ---
@@ -89,11 +89,11 @@ This article shows how to install the client package to set up client VMs runnin
    ```bash
    #!/bin/bash
    set -ex
-   
+
    rpm --import https://packages.microsoft.com/keys/microsoft.asc
-   
+
    DISTRIB_CODENAME=el8
-   
+
    REPO_PATH=/etc/yum.repos.d/amlfs.repo
    echo -e "[amlfs]" > ${REPO_PATH}
    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
    ```bash
    #!/bin/bash
    set -ex
-   
+
    rpm --import https://packages.microsoft.com/keys/microsoft.asc
-   
+
    DISTRIB_CODENAME=el7
-   
+
    REPO_PATH=/etc/yum.repos.d/amlfs.repo
    echo -e "[amlfs]" > ${REPO_PATH}
    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
    ```bash
    #!/bin/bash
    set -ex
-   
+
    rpm --import https://packages.microsoft.com/keys/microsoft.asc
-   
+
    DISTRIB_CODENAME=el8
-   
+
    REPO_PATH=/etc/yum.repos.d/amlfs.repo
    echo -e "[amlfs]" > ${REPO_PATH}
    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
    ```bash
    #!/bin/bash
    set -ex
-   
+
    rpm --import https://packages.microsoft.com/keys/microsoft.asc
-   
+
    DISTRIB_CODENAME=el9
-   
+
    REPO_PATH=/etc/yum.repos.d/amlfs.repo
    echo -e "[amlfs]" > ${REPO_PATH}
    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
    ```bash
    #!/bin/bash
    set -ex
-   
+
    apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
    source /etc/lsb-release
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
    curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
-   
+
    apt update
    ```
 
@@ -271,12 +271,12 @@ This article shows how to install the client package to set up client VMs runnin
    ```bash
    #!/bin/bash
    set -ex
-   
+
    apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
    source /etc/lsb-release
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
    curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
-   
+
    apt update
    ```
 
@@ -322,7 +322,7 @@ This article shows how to install the client package to set up client VMs runnin
 1. Remove any kernels newer than the one mentioned in the LTS metapackage.
 
    ```bash
-   sudo apt remove linux-image-5.15.0-1053-azure
+   sudo apt remove linux-image-6.8.0-1027-azure
    ```
 
    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
    ```bash
    #!/bin/bash
    set -ex
-   
+
    apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
    source /etc/lsb-release
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
    curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
-   
+
    apt update
    ```
 
@@ -363,6 +363,75 @@ This article shows how to install the client package to set up client VMs runnin
 
 ::: zone-end
 
+::: zone pivot="ubuntu-24"
+
+> [!IMPORTANT]
+> 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.
+
+1. Install the LTS kernel metapackage:
+
+   ```bash
+   sudo apt update && sudo apt install linux-image-azure-lts-24.04
+   ```
+
+1. Remove the default (HWE) kernel metapackage. The response to the following command also asks you to remove the `linux-azure` metapackage.
+
+   ```bash
+   sudo apt remove linux-image-azure
+   ```
+
+1. List installed kernels and see which one the LTS metapackage supplies:
+
+   ```bash
+   apt list --installed linux-image*
+   ```
+
+   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.
+
+1. Remove any kernels newer than the one mentioned in the LTS metapackage.
+
+   ```bash
+   sudo apt remove linux-image-6.11.0-1013-azure
+   ```
+
+   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.
+
+1. List installed kernels again to verify that you don't have kernels newer than the one mentioned in the LTS metapackage:
+
+   ```bash
+   apt list --installed linux-image*
+   ```
+
+1. Restart to load the LTS kernel.
+
+1. Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it `repo.bash`:
+
+   ```bash
+    #!/bin/bash
+    set -ex
+
+    apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
+    source /etc/lsb-release
+    echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
+    curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
+
+    apt update
+   ```
+
+1. Run the script as a superuser:
+
+   ```bash
+   sudo bash repo.bash
+   ```
+
+1. Install the metapackage that matches your running kernel.
+
+    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.
+
+   [!INCLUDE [client-install-version-ubunt-24](./includes/client-install-version-ubuntu-24.md)]
+
+::: zone-end
+
 ## Related content
 
 - [Connect clients to an Azure Managed Lustre file system](connect-clients.md)

azure-managed-lustre/client-upgrade.md

@@ -5,7 +5,7 @@ ms.topic: how-to
 author: pauljewellmsft
 ms.author: pauljewell
 ms.reviewer: dsundarraj
-ms.date: 01/10/2025
+ms.date: 04/29/2025
 
 ---
 
@@ -59,7 +59,7 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
 
     If the output shows an old version of the Lustre kernel module, we recommend that you restart (`sudo reboot`) the system.
 
-### [Ubuntu](#tab/ubuntu)
+### [Ubuntu 20.04/22.04](#tab/ubuntu)
 
 1. Unmount any containers or mount points that are mounting the Lustre client by using the following command:
 
@@ -97,6 +97,43 @@ If your client machine uses an older version of Lustre, you can upgrade the Lust
 
     If the output shows an old version of the Lustre kernel module, we recommend that you restart (`sudo reboot`) the system.
 
+### [Ubuntu 24.04](#tab/ubuntu24)
+
+1. Unmount any containers or mount points that are mounting the Lustre client by using the following command:
+
+    ```bash
+    sudo umount <all Lustre mounts>
+    ```
+
+1. Uninstall the existing Lustre client version by using the following command:
+
+    ```bash
+    sudo apt autoremove *lustre* -y
+    ```
+
+1. Install the current version of the Lustre client by using the following command:
+
+    [!INCLUDE [client-upgrade-version-ubuntu](./includes/client-upgrade-version-ubuntu-24.md)]
+
+1. Unload the Lustre and Lustre Networking (LNet) kernel modules by using the following command:
+
+    ```bash
+    sudo lustre_rmmod
+    ```
+
+1. Verify that old kernel modules are removed by using the following command:
+
+    ```bash
+    cat /sys/module/lustre/version; lsmod | grep -E 'lustre|lnet'
+    ```
+
+    The output should look similar to the following example:
+
+    ```bash
+    cat: /sys/module/lustre/version: No such file or directory
+    ```
+
+    If the output shows an old version of the Lustre kernel module, we recommend that you restart (`sudo reboot`) the system.
 ---
 
 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.

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

@@ -0,0 +1,24 @@
+---
+author: t-mialve
+ms.author: normesta
+ms.service: azure-stack
+ms.topic: include
+ms.date: 04/29/2025
+ms.reviewer: rohogue
+---
+
+> [!NOTE]
+> 2.16 is a non-LTS release of Lustre and will stop receiving support from the community soon after the release of 2.17. Please check back in late 2025/early 2026 for more information about the 2.17 release.
+
+```bash
+sudo apt install amlfs-lustre-client-2.16.1-14-gbc76088=$(uname -r)
+```
+
+> [!NOTE]
+> Running `apt search amlfs-lustre-client` doesn't show all available packages for your distribution. To see all available `amlfs-lustre-client` packages, run `apt list -a "amlfs-lustre-client*"`.
+
+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:
+
+```bash
+apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.16.1-14-gbc76088
+```

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

@@ -0,0 +1,12 @@
+---
+author: t-mialve
+ms.author: normesta
+ms.service: azure-stack
+ms.topic: include
+ms.date: 04/29/2025
+ms.reviewer: rohogue
+---
+
+```bash
+sudo apt install -y amlfs-lustre-client-2.16.1-14-gbc76088=$(uname -r)
+```

azure-stack/zone-pivot-groups.yml

@@ -66,6 +66,8 @@ groups:
     title: Ubuntu 20.04
   - id: ubuntu-22
     title: Ubuntu 22.04
+  - id: ubuntu-24
+    title: Ubuntu 24.04
 - id: version-select
   title: AKS enabled by Azure Arc Azure Local versions
   prompt: AKS on Azure Local version