

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 安裝Lustre用戶端
<a name="install-lustre-client"></a>

若要從 Linux 執行個體掛載 Amazon FSx for Lustre 檔案系統，請先安裝開放原始碼Lustre用戶端。然後，根據您的作業系統版本，使用下列其中一個程序。如需核心支援資訊，請參閱 [Lustre 檔案系統和用戶端核心相容性](lustre-client-matrix.md)。

如果您使用 Lustre 用戶端搭配 EFA （彈性布料轉接器），請參閱 [設定 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>

您可以從 Amazon FSx Lustre用戶端 yum 套件儲存庫安裝和更新與 Red Hat Enterprise Linux (RHEL) 和 Rocky Linux 相容的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，其中包含上游原始程式碼的 tarball 和已套用的修補程式集，請使用下列命令。

```
 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>

您可以從 Amazon FSx Lustre用戶端 yum 套件儲存庫安裝和更新與 Red Hat Enterprise Linux (RHEL)、Rocky Linux 和 CentOS 相容的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/8/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**設定 Amazon FSx Lustre用戶端 yum 儲存庫**

Amazon FSx Lustre用戶端 yum 套件儲存庫預設為安裝與核心版本相容的Lustre用戶端，該版本最初隨附於最新支援的 CentOS、Rocky Linux 和 RHEL 8 版本。若要安裝與您正在使用的核心版本相容的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，其中包含上游原始程式碼的 tarball 和已套用的修補程式集，請使用下列命令。

```
 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>

您可以從 Amazon FSx Lustre用戶端 yum 套件儲存庫安裝和更新與 Red Hat Enterprise Linux (RHEL) 和 CentOS 相容的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/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 版，請在 命令`7.8`中使用 `specific_RHEL_version` 取代 。

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

   若要指向 7.7 版，請在 命令`7.7`中使用 `specific_RHEL_version`取代 。

   ```
   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
```

若要下載包含上游原始程式碼 tarball 的原始 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 型 AWS Graviton 支援的執行個體） 上安裝Lustre用戶端
<a name="install-lustre-client-Centos-7-arm"></a>

您可以從 Amazon FSx Lustre用戶端 yum 套件儲存庫安裝和更新Lustre用戶端套件，這些套件與 CentOS 7 for Arm 型 AWS Graviton 支援的 EC2 執行個體相容。這些套件經過簽署，以協助確保它們在下載之前或期間未遭到竄改。如果您未在系統上安裝對應的公有金鑰，儲存庫安裝會失敗。

**新增 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
  ```

#### 其他資訊 (CentOS 7.8 或 7.9 適用於 Arm 型 AWS Graviton 支援的 EC2 執行個體）
<a name="lustre-client-Centos-7-arm-additional-info"></a>

上述命令會安裝掛載和與 Amazon FSx 檔案系統互動所需的兩個套件。儲存庫包含其他Lustre套件，例如包含原始碼的套件和包含測試的套件，您可以選擇性地安裝這些套件。若要列出儲存庫中的所有可用套件，請使用下列命令。

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

若要下載來源 rpm，其中包含上游原始程式碼的 tarball 和已套用的修補程式集，請使用下列命令。

```
 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`套件中指定。

## Ubuntu 搭配預設頁面大小 (4KB)
<a name="lustre-client-ubuntu"></a>

### 在預設頁面大小 (4KB) 的 Ubuntu 18.04、20.04、22.04 或 24.04 上安裝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. 判斷用戶端執行個體上目前執行的核心，並視需要更新。如需 Ubuntu 上Lustre用戶端所需的核心清單，適用於採用 AWS Graviton 處理器的 x86 型 EC2 執行個體和 Arm 型 EC2 執行個體，請參閱 [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)
      ```

      安裝掛載和與您的 FSx for Lustre 檔案系統互動所需的兩個Lustre套件。您可以選擇性地安裝其他相關的套件，例如包含原始碼的套件，以及包含包含在儲存庫中測試的套件。

   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)
   ```

## Ubuntu，64KB 頁面大小
<a name="lustre-client-ubuntu-64k"></a>

### 在 64KB 頁面大小的 Ubuntu24.04 (ARM64) 上安裝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)
      ```

      安裝掛載和與您的 FSx for Lustre 檔案系統互動所需的兩個Lustre套件。您可以選擇性地安裝其他相關的套件，例如包含原始碼的套件，以及包含包含在儲存庫中測試的套件。

   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 SP3, SP4 或 SP5 上安裝Lustre用戶端
<a name="install-lustre-client-SUSE-Linux"></a>

**在 SUSE Linux 12 SP3 上安裝Lustre用戶端**

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 SP4 上安裝Lustre用戶端**

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，且先前已新增 SP3 的 Amazon FSx 儲存庫，請使用下列命令下載並安裝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 SP5 上安裝Lustre用戶端**

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，且先前已新增 SP4 的 Amazon FSx 儲存庫，請使用下列命令下載並安裝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
     ```

**注意**  
您可能需要重新啟動運算執行個體，用戶端才能完成安裝。