Edit

Upgrade Lustre client software to the current version

In this article, you learn how to upgrade an existing Lustre client package to the current version. Upgraded client software is required to connect to an Azure Managed Lustre file system.

If you need to install the client software for the first time, see Install Lustre client software. For the supported distribution matrix and to choose between the prebuilt kmod and DKMS install methods, see Plan your Lustre client installation.

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

Upgrade a Lustre client

If your client machine uses an older version of Lustre, you can upgrade the Lustre client package to the current version by using the following steps. It's important that you completely uninstall the previous Lustre client's kernel modules, in addition to removing the client software packages.

Important

DKMS users: kernel upgrades vs. Lustre version upgrades

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

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

    sudo umount <all Lustre mounts>

  2. Uninstall the existing Lustre client version by using the following command:

    sudo dnf remove *lustre*

  3. Install the current version of the Lustre client:

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

  1. Unload the Lustre and Lustre Networking (LNet) kernel modules by using the following command:

    sudo lustre_rmmod

  2. Verify that old kernel modules are removed by using the following command:

    cat /sys/module/lustre/version; lsmod | grep -E 'lustre|lnet'

    The output should look similar to the following example:

    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.

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

    sudo umount <all Lustre mounts>

  2. Uninstall the existing Lustre client version by using the following command:

    sudo apt autoremove *lustre* -y

  3. Install the current version of the Lustre client:

    sudo apt install -y amlfs-lustre-client-2.15.8-34-gc0f2040=$(uname -r)

  1. Unload the Lustre and Lustre Networking (LNet) kernel modules by using the following command:

    sudo lustre_rmmod

  2. Verify that old kernel modules are removed by using the following command:

    cat /sys/module/lustre/version; lsmod | grep -E 'lustre|lnet'

    The output should look similar to the following example:

    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.

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

    sudo umount <all Lustre mounts>

  2. Uninstall the existing Lustre client version by using the following command:

    sudo apt autoremove *lustre* -y

  3. Install the current version of the Lustre client:

    sudo apt install -y amlfs-lustre-client-2.16.1-14-gbc76088=$(uname -r)

  1. Unload the Lustre and Lustre Networking (LNet) kernel modules by using the following command:

    sudo lustre_rmmod

  2. Verify that old kernel modules are removed by using the following command:

    cat /sys/module/lustre/version; lsmod | grep -E 'lustre|lnet'

    The output should look similar to the following example:

    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.

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

    sudo umount <all Lustre mounts>

  2. Unload the Lustre and Lustre Networking (LNet) kernel modules by using the following command:

    sudo lustre_rmmod

  3. Uninstall the existing Lustre client version by using the following command:

    sudo tdnf remove '*lustre*' -y

  4. Install the current version of the Lustre client:

    sudo tdnf install -y amlfs-lustre-client-2.16.1_21_g153e389-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1

  1. Verify the installation by using the following command:

    sudo modprobe lustre
sleep 5; cat /sys/module/lustre/version; lsmod | grep -E 'lustre|lnet'

    The output should show the new Lustre version (for example, 2.16.1_22_g584eedc).

After you perform this procedure, you can mount the client to your Azure Managed Lustre file system.

Related content

  • Last updated on