Edit

Share via

Install prebuilt Lustre client software

  • Article

In this article, you learn how to download and install a Lustre client package. After you install the package, you can set up client virtual machines (VMs) and attach them to an Azure Managed Lustre cluster. Select an operating system version to see the instructions.

If you need to upgrade an existing Lustre client to the current version, see Upgrade Lustre client software to the current version.

For more information on connecting clients to a cluster, see Connect clients to an Azure Managed Lustre file system.

Upgrade client software for AlmaLinux HPC 8.6

This article shows how to install the client package to set up client VMs running AlmaLinux HPC 8.6.

Install client software for Red Hat Enterprise Linux 7

This article shows how to install the client package to set up client VMs running Red Hat Enterprise Linux 7 (RHEL 7).

Install client software for Red Hat Enterprise Linux 8 or AlmaLinux 8

This article shows how to install the client package to set up client VMs running Red Hat Enterprise Linux 8 (RHEL 8) or AlmaLinux 8.

Note

For AlmaLinux 8.6 HPC images in Azure Marketplace, see the separate AlmaLinux 8.6 HPC installation instructions.

Install client software for Red Hat Enterprise Linux 9

This article shows how to install the client package to set up client VMs running Red Hat Enterprise Linux 9 (RHEL 9).

Install client software for Ubuntu 18.04

This article shows how to install the client package to set up client VMs running Ubuntu 18.04.

Install client software for Ubuntu 20.04

This article shows how to install the client package to set up client VMs running Ubuntu 20.04.

Install client software for Ubuntu 22.04

This article shows how to install the client package to set up client VMs running Ubuntu 22.04.

Download and install prebuilt client software

Warning

These instructions apply only to the AlmaLinux 8.6 HPC images in Azure Marketplace. For all other AlmaLinux 8 installations, including HPC and general marketplace, refer to the Red Hat 8 instructions.

  1. Install and configure the Azure Managed Lustre repository for the DNF package manager. Create the following script and name it repo.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}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

  2. Run the script as a superuser:

    sudo bash repo.bash

  3. Install the metapackage that matches your running kernel:

    sudo dnf install --disableexcludes=main --refresh amlfs-lustre-client-2.15.6_39_g3e00a10-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

    Note

    The metapackage version doesn't always align with the kernel version. Use the preceding command to install the proper metapackage.

    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:

    export NEWKERNELVERSION=6.7.8
sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.6_39_g3e00a10-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

Warning

We're no longer publishing new client packages for Red Hat Enterprise Linux 7. Please migrate to one of the supported releases to run newer versions of the Azure Managed Lustre client packages.

  1. Install and configure the Azure Managed Lustre repository for the YUM package manager. Create the following script and name it repo.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}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

  2. Run the script as a superuser:

    sudo bash repo.bash

  3. Install the metapackage that matches your running kernel.

    The metapackage version doesn't always align with the kernel version. You can use the following command to install the proper metapackage:

    sudo yum install amlfs-lustre-client-2.15.4_42_gd6d405d-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

    Note

    Running dnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run dnf list --showduplicates "amlfs-lustre-client*".

    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:

    export NEWKERNELVERSION=6.7.8
sudo yum upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.4_42_gd6d405d-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

  1. Install and configure the Azure Managed Lustre repository for the DNF package manager. Create the following script and name it repo.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}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

  2. Run the script as a superuser:

    sudo bash repo.bash

  3. Install the metapackage that matches your running kernel.

    The metapackage version doesn't always align with the kernel version. You can use the following command to install the proper metapackage:

    sudo dnf install amlfs-lustre-client-2.15.6_39_g3e00a10-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

    Note

    Running dnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run dnf list --showduplicates "amlfs-lustre-client*".

    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:

    export NEWKERNELVERSION=6.7.8
sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.6_39_g3e00a10-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

  1. Install and configure the Azure Managed Lustre repository for the DNF package manager. Create the following script and name it repo.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}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

  2. Run the script as a superuser:

    sudo bash repo.bash

  3. Install the metapackage that matches your running kernel.

    The metapackage version doesn't always align with the kernel version. You can use the following command to install the proper metapackage:

    sudo dnf install amlfs-lustre-client-2.15.6_39_g3e00a10-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

    Note

    Running dnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run dnf list --showduplicates "amlfs-lustre-client*".

    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:

    export NEWKERNELVERSION=6.7.8
sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.6_39_g3e00a10-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

Warning

We're no longer publishing new client packages for Ubuntu 18.04. Please migrate to one of the supported releases to run newer versions of the Azure Managed Lustre client packages.

Ubuntu 18.04 LTS reached the end of standard support on May 31, 2023. We recommend either migrating to the next Ubuntu LTS release or upgrading to Ubuntu Pro to gain access to extended security and maintenance from Canonical. For more information, see the announcement.

  1. Ensure that you have Ubuntu Pro activated and are on the recommended 5.4 kernel, which the linux-image-azure metapackage provides:

    apt list --installed linux-image*

  2. Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.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

  3. Run the script as a superuser:

    sudo bash repo.bash

  4. 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.

    sudo apt install amlfs-lustre-client-2.15.4-42-gd6d405d=$(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:

    apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.4-42-gd6d405d

  1. Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.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

  2. Run the script as a superuser:

    sudo bash repo.bash

  3. 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.

    sudo apt install amlfs-lustre-client-2.15.6-39-g3e00a10=$(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:

    apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.6-39-g3e00a10

Important

The Azure Marketplace image for the Ubuntu 22.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:

    sudo apt update && sudo apt install linux-image-azure-lts-22.04

  2. Remove the default (HWE) kernel metapackage. The response to the following command also asks you to remove the linux-azure metapackage.

    sudo apt remove linux-image-azure

  3. List installed kernels and see which one the LTS metapackage supplies:

    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.

  4. Remove any kernels newer than the one mentioned in the LTS metapackage.

    sudo apt remove linux-image-5.15.0-1053-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.

  5. List installed kernels again to verify that you don't have kernels newer than the one mentioned in the LTS metapackage:

    apt list --installed linux-image*

  6. Restart to load the LTS kernel.

  7. Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.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

  8. Run the script as a superuser:

    sudo bash repo.bash

  9. 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.

    sudo apt install amlfs-lustre-client-2.15.6-39-g3e00a10=$(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:

    apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.6-39-g3e00a10

Related content