

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 安装 Lustre 客户端
<a name="install-lustre-client"></a>

要从 Linux 实例挂载 Amazon FSx for Lustre 文件系统，请先安装开源Lustre客户端。然后，根据您的操作系统版本，选择下列适用的步骤进行操作。有关内核支持信息，请参阅 [Lustre 文件系统和客户端内核的兼容性](lustre-client-matrix.md)。

如果您使用的是带有 EFA（弹性结构适配器）的 Lustre 客户端，请参阅[配置 EFA 客户端](configure-efa-clients.md)。

如果您的计算实例没有运行安装说明中指定的 Linux 内核，而您又无法更改内核，则可以自己构建 Lustre 客户端。有关更多信息，请参阅 Lustre Wiki 上的[编译 Lustre](http://wiki.lustre.org/Compiling_Lustre)。

## Amazon Linux
<a name="lustre-client-amazon-linux"></a>

### 在 Amazon Linux 2023 上安装 Lustre 客户端
<a name="install-lustre-client-amazon-linux-2023"></a>

1. 在客户端上打开一个终端。

1. 通过运行以下命令确定您的计算实例上当前运行的是哪个内核。

   ```
   uname -r
   ```

1. 查看系统响应，并将其与在 Amazon Linux 2023 上安装 Lustre 客户端的以下最低内核要求进行比较：
   + 6.12 内核最低要求：6.12\$1
   + 6.1 最低内核要求：6.1.79-99.167.amzn2023

   如果您的 EC2 实例满足最低内核要求，请继续执行此步骤并安装 Lustre 客户端。

   如果该命令返回的结果低于内核最低要求，请运行以下命令，更新内核并重启您的 Amazon EC2 实例。

   ```
   sudo dnf -y update kernel && sudo reboot
   ```

   使用 **uname -r** 命令确认是否已更新内核。

1. 使用以下命令下载并安装 Lustre 客户端。

   ```
   sudo dnf install -y lustre-client
   ```

### 在 Amazon Linux 2 上安装 Lustre 客户端
<a name="install-lustre-client-amazon-linux-2"></a>

1. 在客户端上打开一个终端。

1. 通过运行以下命令确定您的计算实例上当前运行的是哪个内核。

   ```
   uname -r
   ```

1. 查看系统响应，并将其与在 Amazon Linux 2 上安装 Lustre 客户端的以下最低内核要求进行比较：
   + 5.10 内核最低要求 – 5.10.144-127.601.amzn2
   + 5.4 内核最低要求 – 5.4.214-120.368.amzn2
   + 4.14 内核最低要求 – 4.14.294-220.533.amzn2

   如果您的 EC2 实例满足最低内核要求，请继续执行此步骤并安装 Lustre 客户端。

   如果该命令返回的结果低于内核最低要求，请运行以下命令，更新内核并重启您的 Amazon EC2 实例。

   ```
   sudo yum -y update kernel && sudo reboot
   ```

   使用 **uname -r** 命令确认是否已更新内核。

1. 使用以下命令下载并安装 Lustre 客户端。

   ```
   sudo amazon-linux-extras install -y lustre
   ```

   如果您无法将内核升级到内核的最低要求，可以使用以下命令安装旧版 2.10 客户端。

   ```
   sudo amazon-linux-extras install -y lustre2.10
   ```

### 在 Amazon Linux 上安装 Lustre 客户端
<a name="install-lustre-client-amazon-linux"></a>

1. 在客户端上打开一个终端。

1. 通过运行以下命令确定您的计算实例上当前运行的是哪个内核。Lustre 客户端需要 Amazon Linux 内核 `4.14, version 104` 或更高版本。

   ```
   uname -r
   ```

1. 请执行以下操作之一：
   + 如果命令返回 `4.14.104-78.84.amzn1.x86_64` 或 4.14 的更高版本，请使用以下命令下载并安装 Lustre 客户端。

     ```
     sudo yum install -y lustre-client
     ```
   +  如果该命令返回的结果低于 `4.14.104-78.84.amzn1.x86_64`，请运行以下命令更新内核并重启您的 Amazon EC2 实例。

     ```
     sudo yum -y update kernel && sudo reboot
     ```

     使用 **uname -r** 命令确认是否已更新内核。然后按照上文所述下载并安装 Lustre 客户端。

## CentOS、Rocky Linux 和 Red Hat
<a name="lustre-client-rhel"></a>

### 在 Red Hat 和 Rocky Linux 9.0 或 9.3—9.7 上安装Lustre客户端
<a name="install-lustre-client-RH9"></a>

您可以从亚马逊Lustre客户端 yum 软件包存储库中安装和更新与红帽企业 Linux (RHEL) 和 Rocky Linux 兼容的 FSx Lustre客户端软件包。这些程序包已签名，以帮助确保下载前或下载过程中未遭篡改。如果您未在系统上安装相应的公有密钥，则存储库安装将失败。

**添加 Amazon FSx Lustre 客户端 yum 包存储库**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令添加存储库并更新程序包管理器。

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/9/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**配置 Amazon FSx Lustre 客户端 yum 存储库**

默认情况下，Amazon FSx Lustre 客户端 yum 包存储库配置为安装与最初随最新支持的 Rocky Linux 和 RHEL 9 版本一起提供的内核版本兼容的Lustre客户端。要安装与您正在使用的内核版本兼容的 Lustre 客户端，则可以编辑存储库配置文件。

本节将介绍如何确定正在运行的内核、是否需要编辑存储库配置以及如何编辑配置文件。

1. 使用以下命令确定您的计算实例上当前运行的内核。

   ```
   uname -r
   ```

1. 请执行以下操作之一：
   + 如果命令返回 `5.14.0-611*`，则无需修改存储库配置。继续执行**安装 Lustre 客户端**步骤。
   +  如果命令返回`5.14.0-570*`，则必须编辑存储库配置，使其指向 Rocky Linux 和 RHEL 9.6 版本的Lustre客户端。
   +  如果命令返回`5.14.0-503*`，则必须编辑存储库配置，使其指向 Rocky Linux 和 RHEL 9.5 版本的Lustre客户端。
   +  如果命令返回`5.14.0-427*`，则必须编辑存储库配置，使其指向 Rocky Linux 和 RHEL 9.4 版本的Lustre客户端。
   +  如果命令返回 `5.14.0-362.18.1`，则必须编辑存储库配置，使其指向 Rocky Linux 和 RHEL 9.3 版本的 Lustre 客户端。
   +  如果命令返回 `5.14.0-70*`，则必须编辑存储库配置，使其指向 Rocky Linux 和 RHEL 9.0 版本的 Lustre 客户端。

1. 使用以下命令编辑存储库配置文件，使其指向特定版本的 RHEL。将 *`specific_RHEL_version`* 替换为需要使用的 RHEL 版本。

   ```
   sudo sed -i 's#9#specific_RHEL_version#' /etc/yum.repos.d/aws-fsx.repo
   ```

   例如，要指向 9.6 版本，请在命令`9.6`中`specific_RHEL_version`替换为，如下例所示。

   ```
   sudo sed -i 's#9#9.6#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. 使用以下命令清除 yum 缓存。

   ```
   sudo yum clean all
   ```

**安装 Lustre 客户端**
+ 使用以下命令从存储库安装程序包。

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### 其他信息（Rocky Linux 和 Red Hat 9.0 及更高版本）
<a name="lustre-client-RH9-additional-info"></a>

前面的命令安装了挂载您的 Amazon FSx 文件系统并与之交互所必需的两个软件包。存储库还包括其他 Lustre 程序包，例如包含源代码的程序包和包含测试的程序包，您可以对它们进行选择性安装。要列出存储库中所有可用的程序包，请使用以下命令。

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

要下载包含上游源代码压缩包且我们已打过补丁的源 rpm，请使用以下命令。

```
 sudo yumdownloader --source kmod-lustre-client
```

运行 yum 更新时，如果有更新版本的模块，则会安装该模块，并替换现有版本。要防止当前安装的版本在更新时被删除，请在 `/etc/yum.conf` 文件中添加如下所示的行。

```
installonlypkgs=kernel, kernel-PAE, installonlypkg(kernel), installonlypkg(kernel-module), 
              installonlypkg(vm), multiversion(kernel), kmod-lustre-client
```

 此列表包括在 `yum.conf` 手册页中指定的默认仅限安装的程序包和 `kmod-lustre-client` 程序包。

### 在 CentOS 和 Red Hat 8.2–8.10 或 Rocky Linux 8.4–8.10 上安装 Lustre 客户端
<a name="install-lustre-client-RH8.2"></a>

您可以从 FSx Lustre亚马逊Lustre客户端 yum 软件包存储库中安装和更新与红帽企业 Linux (RHEL)、Rocky Linux 和 CentOS 兼容的客户端软件包。这些程序包已签名，以帮助确保下载前或下载过程中未遭篡改。如果您未在系统上安装相应的公有密钥，则存储库安装将失败。

**添加 Amazon FSx Lustre 客户端 yum 包存储库**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令添加存储库并更新程序包管理器。

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/8/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**配置 Amazon FSx Lustre 客户端 yum 存储库**

默认情况下，Amazon FSx Lustre 客户端 yum 包存储库配置为安装与最初随最新支持的 CentOS、Rocky Linux 和 RHEL 8 版本一起提供的内核版本兼容的Lustre客户端。要安装与您正在使用的内核版本兼容的 Lustre 客户端，则可以编辑存储库配置文件。

本节将介绍如何确定正在运行的内核、是否需要编辑存储库配置以及如何编辑配置文件。

1. 使用以下命令确定您的计算实例上当前运行的内核。

   ```
   uname -r
   ```

1. 请执行以下操作之一：
   + 如果命令返回 `4.18.0-553*`，则无需修改存储库配置。继续执行**安装 Lustre 客户端**步骤。
   +  如果命令返回 `4.18.0-513*`，则必须编辑存储库配置，使其指向 CentOS、Rocky Linux 和 RHEL 8.9 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-477*`，则必须编辑存储库配置，使其指向 CentOS、Rocky Linux 和 RHEL 8.8 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-425*`，则必须编辑存储库配置，使其指向 CentOS、Rocky Linux 和 RHEL 8.7 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-372*`，则必须编辑存储库配置，使其指向 CentOS、Rocky Linux 和 RHEL 8.6 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-348*`，则必须编辑存储库配置，使其指向 CentOS、Rocky Linux 和 RHEL 8.5 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-305*`，则必须编辑存储库配置，使其指向 CentOS、Rocky Linux 和 RHEL 8.4 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-240*`，则必须编辑存储库配置，使其指向 CentOS 和 RHEL 8.3 版本的 Lustre 客户端。
   +  如果命令返回 `4.18.0-193*`，则必须编辑存储库配置，使其指向 CentOS 和 RHEL 8.2 版本的 Lustre 客户端。

1. 使用以下命令编辑存储库配置文件，使其指向特定版本的 RHEL。

   ```
   sudo sed -i 's#8#specific_RHEL_version#' /etc/yum.repos.d/aws-fsx.repo
   ```

   例如，要指向 8.9 版本，请将命令中的 `8.9` 替换为 `specific_RHEL_version`。

   ```
   sudo sed -i 's#8#8.9#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. 使用以下命令清除 yum 缓存。

   ```
   sudo yum clean all
   ```

**安装 Lustre 客户端**
+ 使用以下命令从存储库安装程序包。

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### 其他信息（CentOS、Rocky Linux 和 Red Hat 8.2 及更高版本）
<a name="lustre-client-RH8.2-additional-info"></a>

前面的命令安装了挂载您的 Amazon FSx 文件系统并与之交互所必需的两个软件包。存储库还包括其他 Lustre 程序包，例如包含源代码的程序包和包含测试的程序包，您可以对它们进行选择性安装。要列出存储库中所有可用的程序包，请使用以下命令。

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

要下载包含上游源代码压缩包且我们已打过补丁的源 rpm，请使用以下命令。

```
 sudo yumdownloader --source kmod-lustre-client
```

运行 yum 更新时，如果有更新版本的模块，则会安装该模块，并替换现有版本。要防止当前安装的版本在更新时被删除，请在 `/etc/yum.conf` 文件中添加如下所示的行。

```
installonlypkgs=kernel, kernel-PAE, installonlypkg(kernel), installonlypkg(kernel-module), 
              installonlypkg(vm), multiversion(kernel), kmod-lustre-client
```

 此列表包括在 `yum.conf` 手册页中指定的默认仅限安装的程序包和 `kmod-lustre-client` 程序包。

### 在 CentOS 和 Red Hat 7.7、7.8 或 7.9（x86\$164 实例）上安装 Lustre 客户端
<a name="install-lustre-client-Centos-7"></a>

您可以从 FSx Lustre亚马逊Lustre客户端 yum 软件包存储库中安装和更新与红帽企业 Linux (RHEL) 和 CentOS 兼容的客户端软件包。这些程序包已签名，以帮助确保下载前或下载过程中未遭篡改。如果您未在系统上安装相应的公有密钥，则存储库安装将失败。

**添加 Amazon FSx Lustre 客户端 yum 包存储库**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令添加存储库并更新程序包管理器。

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/7/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**配置 Amazon FSx Lustre 客户端 yum 存储库**

默认情况下，Amazon FSx Lustre 客户端 yum 软件包存储库配置为安装与最初随最新支持的 CentOS 和 RHEL 7 版本一起提供的内核版本兼容的Lustre客户端。要安装与您正在使用的内核版本兼容的 Lustre 客户端，则可以编辑存储库配置文件。

本节将介绍如何确定正在运行的内核、是否需要编辑存储库配置以及如何编辑配置文件。

1. 使用以下命令确定您的计算实例上当前运行的内核。

   ```
   uname -r
   ```

1. 请执行以下操作之一：
   + 如果命令返回 `3.10.0-1160*`，则无需修改存储库配置。继续执行**安装 Lustre 客户端**步骤。
   +  如果命令返回 `3.10.0-1127*`，则必须编辑存储库配置，使其指向 CentOS 和 RHEL 7.8 版本的 Lustre 客户端。
   +  如果命令返回 `3.10.0-1062*`，则必须编辑存储库配置，使其指向 CentOS 和 RHEL 7.7 版本的 Lustre 客户端。

1. 使用以下命令编辑存储库配置文件，使其指向特定版本的 RHEL。

   ```
   sudo sed -i 's#7#specific_RHEL_version#' /etc/yum.repos.d/aws-fsx.repo
   ```

   要指向版本 7.8，请将命令中的 `specific_RHEL_version` 替换为 `7.8`。

   ```
   sudo sed -i 's#7#7.8#' /etc/yum.repos.d/aws-fsx.repo
   ```

   要指向版本 7.7，请将命令中的 `specific_RHEL_version` 替换为 `7.7`。

   ```
   sudo sed -i 's#7#7.7#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. 使用以下命令清除 yum 缓存。

   ```
   sudo yum clean all
   ```

**安装 Lustre 客户端**
+ 使用以下命令从存储库安装 Lustre 客户端程序包。

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### 其他信息（CentOS 和 Red Hat 7.7 及更高版本）
<a name="lustre-client-Centos-7-additional-info"></a>

前面的命令安装了挂载您的 Amazon FSx 文件系统并与之交互所必需的两个软件包。存储库还包括其他 Lustre 程序包，例如包含源代码的程序包和包含测试的程序包，您可以对它们进行选择性安装。要列出存储库中所有可用的程序包，请使用以下命令。

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

要下载包含上游源代码压缩包且我们已打过补丁的源 rpm ，请使用以下命令。

```
 sudo yumdownloader --source kmod-lustre-client
```

运行 yum 更新时，如果有更新版本的模块，则会安装该模块，并替换现有版本。要防止当前安装的版本在更新时被删除，请在 `/etc/yum.conf` 文件中添加如下所示的行。

```
installonlypkgs=kernel, kernel-big‐mem, kernel-enterprise, kernel-smp,
              kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE,
              kernel-PAE-debug, kmod-lustre-client
```

 此列表包括在 `yum.conf` 手册页中指定的默认仅限安装的程序包和 `kmod-lustre-client` 程序包。

### 在 CentOS 7.8 或 7.9（基于 ARM 的 Graviton 驱动的实例）上安装Lustre客户端 AWS
<a name="install-lustre-client-Centos-7-arm"></a>

对于基 AWS 于 ARM 的 Graviton 的 EC2 实例，您可以从 Amazon FSx Lustre 客户端 yum 包存储库中安装和更新Lustre与 CentOS 7 兼容的客户端软件包。这些程序包已签名，以帮助确保下载前或下载过程中未遭篡改。如果您未在系统上安装相应的公有密钥，则存储库安装将失败。

**添加 Amazon FSx Lustre 客户端 yum 包存储库**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.cn/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. 使用以下命令添加存储库并更新程序包管理器。

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/centos/7/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**配置 Amazon FSx Lustre 客户端 yum 存储库**

默认情况下，Amazon FSx Lustre 客户端 yum 软件包存储库配置为安装与最初随最新支持的 CentOS 7 版本一起提供的内核版本兼容的Lustre客户端。要安装与您正在使用的内核版本兼容的 Lustre 客户端，则可以编辑存储库配置文件。

本节将介绍如何确定正在运行的内核、是否需要编辑存储库配置以及如何编辑配置文件。

1. 使用以下命令确定您的计算实例上当前运行的内核。

   ```
   uname -r
   ```

1. 请执行以下操作之一：
   + 如果命令返回 `4.18.0-193*`，则无需修改存储库配置。继续执行**安装 Lustre 客户端**步骤。
   +  如果命令返回 `4.18.0-147*`，则必须编辑存储库配置，使其指向 CentOS 7.8 版本的 Lustre 客户端。

1. 用以下命令编辑存储库配置文件，使其指向 CentOS 7.8 版本。

   ```
   sudo sed -i 's#7#7.8#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. 使用以下命令清除 yum 缓存。

   ```
   sudo yum clean all
   ```

**安装 Lustre 客户端**
+ 使用以下命令从存储库安装程序包。

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### 其他信息（基于 AR AWS M 的 Graviton 驱动的 EC2 实例适用于 CentOS 7.8 或 7.9）
<a name="lustre-client-Centos-7-arm-additional-info"></a>

前面的命令安装了挂载您的 Amazon FSx 文件系统并与之交互所必需的两个软件包。存储库还包括其他 Lustre 程序包，例如包含源代码的程序包和包含测试的程序包，您可以对它们进行选择性安装。要列出存储库中所有可用的程序包，请使用以下命令。

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

要下载包含上游源代码压缩包且我们已打过补丁的源 rpm，请使用以下命令。

```
 sudo yumdownloader --source kmod-lustre-client
```

运行 yum 更新时，如果有更新版本的模块，则会安装该模块，并替换现有版本。要防止当前安装的版本在更新时被删除，请在 `/etc/yum.conf` 文件中添加如下所示的行。

```
installonlypkgs=kernel, kernel-big‐mem, kernel-enterprise, kernel-smp,
              kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE,
              kernel-PAE-debug, kmod-lustre-client
```

 此列表包括在 `yum.conf` 手册页中指定的默认仅限安装的程序包和 `kmod-lustre-client` 程序包。

## 使用默认页面大小 (4KB) 的 Ubuntu
<a name="lustre-client-ubuntu"></a>

### 要在 Ubuntu 18.04、20.04、22.04 或 24.04 上使用默认页面大小 (4KB) 安装Lustre客户端
<a name="install-lustre-client-Ubuntu"></a>

您可以从 Amazon FSx Ubuntu 存储库中获取Lustre软件包。为了验证存储库的内容在下载之前或下载过程中未遭篡改，系统会对存储库的元数据应用 GNU Privacy Guard（GPG）签名。您的系统上必须安装正确的 GPG 公有密钥，否则存储库将安装失败。

1. 在客户端上打开一个终端。

1. 按照以下步骤添加 Amazon FSx Ubuntu 存储库：

   1. 如果您之前未在客户端实例上注册 Amazon FSx Ubuntu 存储库，请下载并安装所需的公钥。使用以下命令。

      ```
      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null
      ```

   1. 使用以下命令将 Amazon FSx 包存储库添加到您的本地包管理器。

      ```
      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'
      ```

1. 确定您的客户端实例上当前正在运行的内核，并根据需要进行更新。有关适用于基于 x86 的 EC2 实例和由 AWS Graviton 处理器提供支持的基于 ARM 的 EC2 实例的 Ubuntu 上 Lustre 客户端所需的内核列表，请参阅 [Ubuntu 客户端](lustre-client-matrix.md#ubuntu-clients)。

   1. 运行以下命令确定正在运行的内核。

      ```
      uname -r
      ```

   1. 运行以下命令，更新到最新版本的 Ubuntu 内核和 Lustre，然后重新启动。

      ```
      sudo apt install -y linux-aws lustre-client-modules-aws && sudo reboot
      ```

       如果您的内核版本同时高于基于 x86 的 EC2 实例和基于 Graviton 的 EC2 实例的最低内核版本，并且您不希望更新到最新的内核版本，则可以使用以下命令为当前内核安装 Lustre。

      ```
      sudo apt install -y lustre-client-modules-$(uname -r)
      ```

      安装了 for Lustre 文件系统并与之交互所需的两个Lustre软件包。 FSx 您可以选择安装其他相关的程序包，例如存储库中包含源代码的程序包和包含测试的程序包。

   1. 使用以下命令列出存储库中所有可用的程序包。

      ```
      sudo apt-cache search ^lustre
      ```

   1. （可选）如果您希望系统升级且始终升级 Lustre 客户端模块，请确保使用以下命令安装 `lustre-client-modules-aws` 程序包。

      ```
      sudo apt install -y lustre-client-modules-aws
      ```

**注意**  
如果出现 `Module Not Found` 错误，请参阅 [缺失模块错误故障排除](#ubuntu-missing-module)。

### 缺失模块错误故障排除
<a name="ubuntu-missing-module"></a>

如果您在任何版本的 Ubuntu 上安装时 `Module Not Found` 遇到错误，请执行以下操作：

将内核降级为最新的支持版本。列出该 lustre-client-modules软件包的所有可用版本并安装相应的内核。要执行此操作，请使用以下命令。

```
sudo apt-cache search lustre-client-modules
```

例如，如果存储库中提供的最新版本是 `lustre-client-modules-5.4.0-1011-aws`，请执行以下操作：

1. 使用以下命令安装为此程序包构建的内核。

   ```
   sudo apt-get install -y linux-image-5.4.0-1011-aws
   ```

   ```
   sudo sed -i 's/GRUB_DEFAULT=.\+/GRUB\_DEFAULT="Advanced options for Ubuntu>Ubuntu, with Linux 5.4.0-1011-aws"/' /etc/default/grub
   ```

   ```
   sudo update-grub
   ```

1. 使用以下命令重启实例。

   ```
   sudo reboot
   ```

1. 使用以下命令安装 Lustre 客户端。

   ```
   sudo apt-get install -y lustre-client-modules-$(uname -r)
   ```

## 页面大小为 64KB 的 Ubuntu
<a name="lustre-client-ubuntu-64k"></a>

### 在 Ubuntu24.04 (ARM64) 上安装页面大小为 64KB 的Lustre客户端
<a name="install-lustre-client-ubuntu-64k"></a>

您可以从 Amazon FSx Ubuntu 存储库中获取Lustre软件包。为了验证存储库的内容在下载之前或下载过程中未遭篡改，系统会对存储库的元数据应用 GNU Privacy Guard（GPG）签名。您的系统上必须安装正确的 GPG 公有密钥，否则存储库将安装失败。

1. 在客户端上打开一个终端。

1. 验证您的实例使用的页面大小是否为 64KB。输出应该是`65536`。

   ```
   getconf PAGESIZE
   ```

   

1. 按照以下步骤添加 Amazon FSx Ubuntu 存储库：

   1. 如果您之前未在客户端实例上注册 Amazon FSx Ubuntu 存储库，请下载并安装所需的公钥。使用以下命令。

      ```
      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null
      ```

   1. 使用以下命令将 Amazon FSx 包存储库添加到您的本地包管理器。

      ```
      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'
      ```

1. 确定您的客户端实例上当前正在运行的内核，并根据需要进行更新。你的 Ubuntu 24 内核版本必须是`6.14.0-1018-aws-64k`或更高版本。

   1. 运行以下命令确定正在运行的内核。

      ```
      uname -r
      ```

   1. 运行以下命令，更新到最新版本的 Ubuntu 内核和 Lustre，然后重新启动。

      ```
      sudo apt install -y linux-aws-64k lustre-client-modules-aws-64k && sudo reboot
      ```

      如果您的内核版本高于`6.14.0-1018-aws-64k`基于 Graviton 的 EC2 实例，并且您不想更新到最新的内核版本，则可以使用以下命令Lustre为当前内核进行安装。

      ```
      sudo apt install -y lustre-client-modules-$(uname -r)
      ```

      安装了 for Lustre 文件系统并与之交互所需的两个Lustre软件包。 FSx 您可以选择安装其他相关的程序包，例如存储库中包含源代码的程序包和包含测试的程序包。

   1. 使用以下命令列出存储库中所有可用的程序包。

      ```
      sudo apt-cache search ^lustre
      ```

   1. （可选）如果您希望系统升级且始终升级 Lustre 客户端模块，请确保使用以下命令安装 `lustre-client-modules-aws-64k` 程序包。

      ```
      sudo apt install -y lustre-client-modules-aws-64k
      ```

## SUSE Linux
<a name="lustre-client-suse"></a>

### 要在 SUSE Linux 12 上安装Lustre客户端 SP3 SP4，或 SP5
<a name="install-lustre-client-SUSE-Linux"></a>

**在 SUSE Linux 12 上安装Lustre客户端 SP3**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import fsx-sles-public-key.asc
   ```

1. 使用以下命令为 Lustre 客户端添加存储库。

   ```
   sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo
   ```

1. 使用以下命令下载并安装 Lustre 客户端。

   ```
   sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
   sudo sed -i 's#SLES-12#SP3#' /etc/zypp/repos.d/aws-fsx.repo
   sudo zypper refresh
   sudo zypper in lustre-client
   ```

**在 SUSE Linux 12 上安装Lustre客户端 SP4**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import fsx-sles-public-key.asc
   ```

1. 使用以下命令为 Lustre 客户端添加存储库。

   ```
   sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo
   ```

1. 请执行以下操作之一：
   + 如果是 SP4 直接安装的，请使用以下命令下载并安装Lustre客户端。

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo sed -i 's#SLES-12#SP4#' /etc/zypp/repos.d/aws-fsx.repo
     sudo zypper refresh
     sudo zypper in lustre-client
     ```
   + 如果您从迁移 SP3 到 SP4 并之前添加了的 Amazon FSx 存储库 SP3，请使用以下命令下载并安装Lustre客户端。

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo sed -i 's#SP3#SP4#' /etc/zypp/repos.d/aws-fsx.repo
     sudo zypper ref
     sudo zypper up --force-resolution lustre-client-kmp-default
     ```

**在 SUSE Linux 12 上安装Lustre客户端 SP5**

1. 在客户端上打开一个终端。

1. 使用以下命令安装 Amazon FSx rpm 公钥。

   ```
   sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc
   ```

1. 使用以下命令导入密钥。

   ```
   sudo rpm --import fsx-sles-public-key.asc
   ```

1. 使用以下命令为 Lustre 客户端添加存储库。

   ```
   sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo
   ```

1. 请执行以下操作之一：
   + 如果是 SP5 直接安装的，请使用以下命令下载并安装Lustre客户端。

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo zypper refresh
     sudo zypper in lustre-client
     ```
   + 如果您从迁移 SP4 到 SP5 并之前添加了的 Amazon FSx 存储库 SP4，请使用以下命令下载并安装Lustre客户端。

     ```
     sudo sed -i 's#SP4#SLES-12' /etc/zypp/repos.d/aws-fsx.repo
     sudo zypper ref
     sudo zypper up --force-resolution lustre-client-kmp-default
     ```

**注意**  
您可能需要重启计算实例，客户端才能完成安装。