安装 Lustre 客户端软件

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

在安装之前，请参阅规划 Lustre 客户端安装以获取支持矩阵，并在预生成的 kmod 和 DKMS 安装方法之间进行选择。

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

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

有关 Azure Managed Lustre 在受信任启动虚拟机和机密计算虚拟机中的行为的详细信息，请参阅将安全启动与 Azure Managed Lustre 文件系统配合使用。

安装 AlmaLinux 8 的客户端软件

本文介绍如何安装客户端包以设置运行 AlmaLinux 8 的客户端 VM。

安装 AlmaLinux 9 的客户端软件

本文介绍如何安装客户端包以设置运行 AlmaLinux 9 的客户端 VM。

为 Ubuntu 22.04 安装客户端软件

本文介绍如何安装客户端包以设置运行 Ubuntu 22.04 的客户端 VM。

安装 Ubuntu 24.04 的客户端软件

本文介绍如何安装客户端包以设置运行 Ubuntu 24.04 的客户端 VM。

下载并安装客户端软件

Important

Microsoft建议在 AlmaLinux 8.10（最新（和终端）RHEL 8 次要版本上运行。 RHEL 8 处于维护支持阶段，Red Hat 仅提供 8.10 的安全错误。较旧的 8.x 次版本（8.6 至 8.9）不再接收 Red Hat 勘误更新。

验证正在运行的 RHEL 次要版本：
```
cat /etc/redhat-release
```
RHEL 8.10 系统的预期输出：
```
Red Hat Enterprise Linux release 8.10 (Ootpa)
```
如果系统处于较旧的 8.x 次要版本，请升级到 8.10：
```
sudo dnf upgrade --refresh -y
sudo reboot
```

安装和配置 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}

以超级用户身份运行脚本：
```
sudo bash repo.bash
```
安装 Lustre 客户端包。选择最符合需求的安装方法：
- 预构建 kmod
- DKMS
元包版本并不总是与内核版本保持一致。使用以下命令安装正确的元包：
```
sudo dnf install amlfs-lustre-client-2.15.8_34_gc0f2040-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

运行 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.8_34_gc0f2040-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
```
sudo dnf install -y lustre-client-dkms-2.15.8_35_gdf4872c
```
此 DKMS 包自动包括匹配的 Lustre 用户空间工具包（lustre-client）作为依赖项。因此，单个 dnf install 命令提供模块源和用户空间工具。

DKMS 包会自动为正在运行的内核编译 Lustre 内核模块。与预生成的 kmod 包不同，无需匹配特定的内核版本，也不需要用于 sed 转换内核版本字符串。升级内核时，DKMS 会自动重新生成模块。

Note

DKMS 需要内核标头（kernel-devel）、GCC 和 Make 才能安装。包依赖项会自动处理此要求，但初始安装需要几分钟时间，而内核模块编译。

Important

Azure Managed Lustre客户端包尚不支持 AlmaLinux 9.8（发布日期：2026 年 5 月 19 日）。预计相关支持将随即将发布的 Lustre 2.15.9 版本一同推出。在安装 Lustre 客户端之前，请确保 VM 处于受支持的次要版本。查看支持矩阵以获取当前列表——一旦 Azure Managed Lustre 发布适用于 9.8 的软件包，9.8 就会列在其中。

Important

对于生产工作负荷，Microsoft建议在安装 Lustre 客户端之前将 RHEL 9 系统固定到 Red Hat 扩展更新支持（EUS）次要版本。固定版本可使内核保持在 Microsoft 主动用于验证 Lustre 客户端的稳定 z-stream 中。

AlmaLinux 9 没有 EUS 计划。出于相同的稳定性原因，Microsoft建议将 AlmaLinux 9 固定到特定的次要版本（当前9.6），这样内核就不会意外地向前滚动。

Important

下面的过程将系统固定在其当前运行的次要版本——它不会更改系统当前所在的次要版本。如果 cat /etc/redhat-release 报告的次要版本高于 9.6，本文不涵盖回滚。

最可靠的路径是从 Azure 市场 中的 AlmaLinux 9.6 映像部署新 VM，并在此处重新安装 Lustre 客户端。是否能够就地回滚到较早的次要版本，取决于系统的订阅类型、RHUI 或 BYOS 配置以及 EUS 权益；有关降级流程，请参阅 Red Hat 文档或联系您的 Red Hat 支持渠道。

将系统固定到受支持的次要版本，以便内核在下一次更新时不会前滚到不支持的次要版本。

AlmaLinux 9 （次要版本引脚，而不是 EUS）：

AlmaLinux 9 不提供 EUS。以下步骤会将 DNF 的 releasever 固定为 9.6，以便系统在下一个 dnf upgrade 时不会升级到更新的次要版本：
```
echo '9.6' | sudo tee /etc/dnf/vars/releasever
sudo dnf clean all && sudo dnf makecache
```

安装和配置 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}

以超级用户身份运行脚本：
```
sudo bash repo.bash
```
安装 Lustre 客户端包。选择最符合需求的安装方法：
- 预构建 kmod
- DKMS
元包版本并不总是与内核版本保持一致。可以使用以下命令安装正确的元包：
```
sudo dnf install amlfs-lustre-client-2.15.8_34_gc0f2040-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

运行 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.8_34_gc0f2040-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
```
sudo dnf install -y lustre-client-dkms-2.15.8_35_gdf4872c
```
此 DKMS 包自动包括匹配的 Lustre 用户空间工具包（lustre-client）作为依赖项。因此，单个 dnf install 命令提供模块源和用户空间工具。

DKMS 包会自动为正在运行的内核编译 Lustre 内核模块。与预生成的 kmod 包不同，无需匹配特定的内核版本，也不需要用于 sed 转换内核版本字符串。升级内核时，DKMS 会自动重新生成模块。

Note

DKMS 需要内核标头（kernel-devel）、GCC 和 Make 才能安装。包依赖项会自动处理此要求，但初始安装需要几分钟时间，而内核模块编译。

Important

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

安装 LTS 内核元包：

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

移除默认 (HWE) 内核元包。对以下命令的响应还要求删除 linux-azure 元包。
```
sudo apt remove linux-image-azure
```
列出已安装的内核，并查看 LTS 元包提供哪些内核：
```
apt list --installed linux-image*
```
新预配的主机有两个内核，而较旧的主机可能有更多的内核。将 LTS 元包提供的版本与其他已安装的内核进行比较。
删除比 LTS 元包中提到的内核更新的任何内核。
```
sudo apt remove linux-image-6.8.0-1027-azure
```
您会收到有关删除内核的警告，但如果在新配置的主机上遵循这些步骤，这些方法会起作用。如果担心，请参阅有关配置内核的 Ubuntu 文档，以确保它们可以在重启后启动。
再次列出已安装的内核，以验证你是否没有比 LTS 元包中提到的内核更新的内核：
```
apt list --installed linux-image*
```
重启以加载 LTS 内核。

安装和配置 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

以超级用户身份运行脚本：
```
sudo bash repo.bash
```
安装 Lustre 客户端包。选择最符合需求的安装方法：
- 预构建 kmod
- DKMS
以下命令安装一个元包，该元包使 Lustre 版本与已安装的内核保持一致。若要使这种对齐正常工作，必须在更新系统时使用 apt full-upgrade 而不是 apt upgrade。
```
sudo apt install amlfs-lustre-client-2.15.8-34-gc0f2040=$(uname -r)
```
Note

运行 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.8-34-gc0f2040
```
```
sudo apt install -y amlfs-lustre-client-dkms-2.15.8-35-gdf4872c
```
此元包会将 Lustre 用户态工具（lustre-client）与 DKMS 模块源代码包（lustre-client-modules-dkms）一并安装，以便它们保持版本一致。

DKMS 包会自动为正在运行的内核编译 Lustre 内核模块。与预生成的 kmod 包不同，无需匹配特定的内核版本 - DKMS 会在升级内核时自动重新生成模块。

Note

DKMS 需要安装内核标头、GCC 和 Make。包依赖项会自动处理此要求，但初始安装需要几分钟时间，而内核模块编译。

Important

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

安装 LTS 内核元包：

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

移除默认 (HWE) 内核元包。对以下命令的响应还要求删除 linux-azure 元包。
```
sudo apt remove linux-image-azure
```
列出已安装的内核，并查看 LTS 元包提供哪些内核：
```
apt list --installed linux-image*
```
新预配的主机有两个内核，而较旧的主机可能有更多的内核。将 LTS 元包提供的版本与其他已安装的内核进行比较。
删除比 LTS 元包中提到的内核更新的任何内核。
```
sudo apt remove linux-image-6.11.0-1013-azure
```
您会收到有关删除内核的警告，但如果在新配置的主机上遵循这些步骤，这些方法会起作用。如果担心，请参阅有关配置内核的 Ubuntu 文档，以确保它们可以在重启后启动。
再次列出已安装的内核，以验证你是否没有比 LTS 元包中提到的内核更新的内核：
```
apt list --installed linux-image*
```
重启以加载 LTS 内核。

安装和配置 APT 包管理器的 Azure 托管 Lustre 存储库。创建以下脚本并将其命名 repo.bash：

 #!/bin/bash
 set -ex

 apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg dpkg-dev
 source /etc/lsb-release
 ARCH=$(dpkg-architecture -q DEB_BUILD_ARCH)
 echo "deb [arch=${ARCH}] 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

以超级用户身份运行脚本：
```
sudo bash repo.bash
```
安装 Lustre 客户端包。选择最符合需求的安装方法：
- 预构建 kmod
- DKMS
以下命令安装一个元包，该元包使 Lustre 版本与已安装的内核保持一致。若要使这种对齐正常工作，必须在更新系统时使用 apt full-upgrade 而不是 apt upgrade。

Note

版本 2.17 是 Lustre 的非 LTS 版本，社区支持在版本 2.18 发布后不久结束。有关 2.18 版本的详细信息，请稍后重新查看。
```
sudo apt install amlfs-lustre-client-2.17.0-24-gf517bc4=$(uname -r)
```
Note

运行 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.17.0-24-gf517bc4
```
Note

2.17 是 Lustre 的非 LTS 版本。社区支持在 2.18 版本之后不久结束。
```
sudo apt install -y amlfs-lustre-client-dkms-2.17.0-24-gf517bc4
```
此元包会将 Lustre 用户态工具（lustre-client）与 DKMS 模块源代码包（lustre-client-modules-dkms）一并安装，以便它们保持版本一致。

DKMS 包会自动为正在运行的内核编译 Lustre 内核模块。与预生成的 kmod 包不同，无需匹配特定的内核版本。升级内核时，DKMS 会自动重新生成模块。

Note

DKMS 需要安装内核标头、GCC 和 Make。包依赖项会自动处理此要求，但初始安装需要几分钟时间，而内核模块编译。

Last updated on 2026-09-11

安装 Lustre 客户端软件

安装 AlmaLinux 8 的客户端软件

安装 AlmaLinux 9 的客户端软件

为 Ubuntu 22.04 安装客户端软件

安装 Ubuntu 24.04 的客户端软件

下载并安装客户端软件

相关内容

其他资源