安装预生成的 Lustre 客户端软件

本文介绍如何下载并安装 Lustre 客户端包。 安装后,可以设置客户端 VM 并将其附加到 Azure 托管 Lustre 群集。 选择操作系统版本以查看说明。

如果需要将现有 Lustre 客户端升级到当前版本,请参阅 将 Lustre 客户端升级到当前版本

有关将客户端连接到群集的详细信息,请参阅 将客户端连接到 Azure 托管 Lustre 文件系统

升级客户端软件

本教程介绍如何安装客户端包以设置运行 AlmaLinux HPC 8.6 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • AlmaLinux HPC 8.6

安装 Red Hat Enterprise Linux 7 的客户端软件

本教程介绍如何安装客户端包以设置运行 RHEL 7 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • Red Hat Enterprise Linux 7 (RHEL 7)

安装 Red Hat Enterprise Linux 或 AlmaLinux 8 的客户端软件

本教程介绍如何安装客户端包以设置运行 RHEL 8 或 Alma 8 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • Red Hat Enterprise Linux 8 (RHEL 8)
  • Alma Linux 8

注意

有关 AlmaLinux 8.6 HPC 市场映像,请参阅单独的 Alma 8.6 HPC 安装说明

安装 Red Hat Enterprise Linux 9 的客户端软件

本教程介绍如何安装客户端包以设置运行 RHEL 9 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • Red Hat Enterprise Linux 9 (RHEL 9)

为 Ubuntu 18.04 安装客户端软件

本教程介绍如何安装客户端包以设置运行 Ubuntu 18.04 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • Ubuntu 18.04

为 Ubuntu 20.04 安装客户端软件

本教程介绍如何安装客户端包以设置运行 Ubuntu 20.04 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • Ubuntu 20.04

为 Ubuntu 22.04 安装客户端软件

本教程介绍如何安装客户端包以设置运行 Ubuntu 22.04 的客户端 VM,并将其附加到 Azure 托管 Lustre 群集。

这些说明适用于正在运行的客户端 VM:

  • Ubuntu 22.04

下载并安装预生成的客户端软件

警告

这些说明仅适用于 AlmaLinux 8.6 HPC 市场映像。 有关所有其他 AlmaLinux 8 安装(包括 HPC 和常规市场),请参阅 Red Hat 8 说明

  1. 安装和配置 DNF 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  3. 安装与正在运行的内核匹配的元包:

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

    注意

    元包版本并不总是与内核版本保持一致。 使用上面的 install 命令安装正确的元包。

    如果只想升级内核而不是所有包,则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

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

警告

不再发布 Red Hat Enterprise Linux 7 的新客户端包。 请迁移到其中一个受支持的版本,以运行较新版本的 Azure 托管 Lustre 客户端包。

  1. 安装和配置 YUM 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  3. 安装与正在运行的内核匹配的元包。

    元包版本并不总是与内核版本保持一致。 可以使用以下命令安装正确的元包:

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

    注意

    运行 dnf search amlfs-lustre-client 不显示发行版的所有可用包。 若要查看所有可用的 amlfs-lustre-client 包,请运行 dnf list --showduplicates "amlfs-lustre-client*"

    如果只想升级内核而不是所有包,则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

    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. 安装和配置 DNF 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  3. 安装与正在运行的内核匹配的元包:

    元包版本并不总是与内核版本保持一致。 可以使用以下命令安装正确的元包:

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

    注意

    运行 dnf search amlfs-lustre-client 不显示发行版的所有可用包。 若要查看所有可用的 amlfs-lustre-client 包,请运行 dnf list --showduplicates "amlfs-lustre-client*"

    如果只想升级内核而不是所有包,则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

    export NEWKERNELVERSION=6.7.8
    sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.5_41_gc010524-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
    
  1. 安装和配置 DNF 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  3. 安装与正在运行的内核匹配的元包。

    元包版本并不总是与内核版本保持一致。 可以使用以下命令安装正确的元包:

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

    注意

    运行 dnf search amlfs-lustre-client 不显示发行版的所有可用包。 若要查看所有可用的 amlfs-lustre-client 包,请运行 dnf list --showduplicates "amlfs-lustre-client*"

    如果只想升级内核而不是所有包,则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

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

警告

我们不再发布 适用于 Ubuntu 18.04 的新客户端包。 请迁移到其中一个受支持的版本,以运行较新版本的 Azure 托管 Lustre 客户端包。

Ubuntu 18.04 LTS 于 2023 年 5 月 31 日终止标准支持。 Microsoft建议迁移到下一个 Ubuntu LTS 版本或升级到 Ubuntu Pro,以便从 Canonical 访问扩展的安全和维护。 有关详细信息,请参阅公告

  1. 确保已激活 Ubuntu Pro,并且位于建议的 5.4 内核上,linux-image-azure 元包提供:

    apt list --installed linux-image*
    
  2. 安装和配置 APT 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  4. 安装与正在运行的内核匹配的元包。

    以下命令安装一个元包,该元包使 Lustre 版本与已安装的内核保持一致。 若要执行此操作,必须使用系统,而不是apt upgrade在更新系统时使用apt full-upgrade

    sudo apt install amlfs-lustre-client-2.15.4-42-gd6d405d=$(uname -r)
    

    注意

    运行 apt search amlfs-lustre-client 不显示发行版的所有可用包。 若要查看所有可用的 amlfs-lustre-client 包,请运行 apt list -a "amlfs-lustre-client*"。 (可选)如果要仅升级内核(而不是所有包),则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

    apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.4-42-gd6d405d
    
  1. 安装和配置 APT 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  3. 安装与正在运行的内核匹配的元包。

    以下命令安装一个元包,该元包使 Lustre 版本与已安装的内核保持一致。 若要执行此操作,必须使用系统,而不是apt upgrade在更新系统时使用apt full-upgrade

    sudo apt install amlfs-lustre-client-2.15.5-41-gc010524=$(uname -r)
    

    注意

    运行 apt search amlfs-lustre-client 不显示发行版的所有可用包。 若要查看所有可用的 amlfs-lustre-client 包,请运行 apt list -a "amlfs-lustre-client*"

    (可选)如果要仅升级内核(而不是所有包),则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

    apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.5-41-gc010524
    

重要

Ubuntu 22.04 LTS 版本的Azure 市场映像默认使用硬件启用(HWE)内核。 但是,这些内核仅在 6 个月内受支持,而 Lustre 对这些内核的支持在发布时通常不可用。 因此,我们建议切换到 LTS 内核,因为它提供更多的稳定性,并维护 Lustre 客户端支持的内核版本。

  1. 安装 LTS 内核元包。

    sudo apt update && sudo apt install linux-image-azure-lts-22.04
    
  2. 删除 HWE 内核元包。

    删除默认的(硬件启用)内核元包。 它还会要求删除 linux-azure 元包。 这是正常情况。

    sudo apt remove linux-image-azure
    
  3. 列出已安装的内核,并查看 LTS 元包提供的内核。

    删除元数据包后,请检查当前安装了哪些内核。 新预配的主机将有两个内核,而较旧的主机可能有更多的内核。 将 LTS 元包提供的版本与其他已安装的内核进行比较。 在此处可以看到,以前仍从 linux-image-azure 元包安装 6.2 内核。

    apt list --installed linux-image*
    
  4. 删除比 LTS 元包中提到的内核更新的任何内核。

    收到有关删除内核的警告,但如果在新预配的主机上遵循这些步骤,这些步骤将起作用。 但是,如果有疑问,请参阅有关配置内核的 Ubuntu 文档,以确保在重新启动后能够启动。

    sudo apt remove linux-image-5.15.0-1053-azure
    
  5. 验证你是否没有比 LTS 元包中提到的内核更新的内核。

    apt list --installed linux-image*
    
  6. 重新启动以加载 LTS 内核。

  7. 安装和配置 APT 包管理器的 Azure 托管 Lustre 存储库。 创建以下脚本并将其命名 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. 以超级用户身份执行脚本:

    sudo bash repo.bash
    
  9. 安装与正在运行的内核匹配的元包。

    以下命令安装一个元包,该元包使 Lustre 版本与已安装的内核保持一致。 若要执行此操作,必须使用系统,而不是apt upgrade在更新系统时使用apt full-upgrade

    sudo apt install amlfs-lustre-client-2.15.5-41-gc010524=$(uname -r)
    

    注意

    运行 apt search amlfs-lustre-client 不显示发行版的所有可用包。 若要查看所有可用的 amlfs-lustre-client 包,请运行 apt list -a "amlfs-lustre-client*"

    (可选)如果要仅升级内核(而不是所有包),则至少必须升级 amlfs-lustre-client 元包,以便 Lustre 客户端在重新启动后继续工作。 命令应类似于以下示例:

    apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.5-41-gc010524
    

后续步骤