

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Lustre 클라이언트 설치
<a name="install-lustre-client"></a>

Linux 인스턴스에서 Amazon FSx for Lustre 파일 시스템을 탑재하려면 먼저 오픈 소스 Lustre 클라이언트를 설치합니다. 그런 다음 운영 체제 버전에 따라 다음 절차 중 하나를 사용합니다. 커널 지원 정보는 [Lustre 파일 시스템 및 클라이언트 커널 호환성](lustre-client-matrix.md)을 참조하세요.

EFA(Elastic Fabric Adapter)와 함께 Lustre 클라이언트를 사용하는 경우 섹션을 참조하세요[EFA 클라이언트 구성](configure-efa-clients.md).

컴퓨팅 인스턴스가 설치 지침에 지정된 Linux 커널을 실행하지 않고, 커널을 변경할 수 없는 경우, 자체 Lustre 클라이언트를 구축할 수 있습니다. 자세한 내용은 Lustre 위키에서 [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\*
   + 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 클라이언트를 가리키도록 리포지토리 구성을 편집해야 합니다.
   +  명령이를 반환하는 경우 Rocky Linux 및 RHEL 9.5 릴리스의 Lustre 클라이언트를 가리키도록 리포지토리 구성을 편집`5.14.0-503*`해야 합니다.
   +  명령이를 반환`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>

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 패키지 리포지토리는 기본적으로 지원되는 최신 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\_64 인스턴스)에 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을 표시하려면 명령에서 `{{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에 Lustre 클라이언트를 설치하려면(Arm 기반 AWS Graviton 기반 인스턴스)
<a name="install-lustre-client-Centos-7-arm"></a>

Arm 기반 AWS Graviton 구동 EC2 인스턴스용 CentOS 7과 호환되는 Amazon FSx Lustre 클라이언트 yum 패키지 리포지토리에서 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
   ```

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

#### 추가 정보(ARM 기반 AWS 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>

### 기본 페이지 크기(4KB)로 Ubuntu 18.04, 20.04, 22.04 또는 24.04에 Lustre 클라이언트를 설치하려면
<a name="install-lustre-client-Ubuntu"></a>

Amazon FSx 리포지토리에서 Lustre 패키지를 다운로드할 수 있습니다. 다운로드 전 또는 다운로드 중에 리포지토리의 콘텐츠가 변조되지 않았는지 확인하기 위해 GPG(GNU Privacy Guard) 서명이 리포지토리의 메타데이터에 적용됩니다. 시스템에 올바른 퍼블릭 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)
      ```

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

## 64KB 페이지 크기가 있는 Ubuntu
<a name="lustre-client-ubuntu-64k"></a>

### 64KB 페이지 크기로 Ubuntu24.04(ARM64)에 Lustre 클라이언트를 설치하려면ARM64 64KB
<a name="install-lustre-client-ubuntu-64k"></a>

Amazon FSx 리포지토리에서 Lustre 패키지를 다운로드할 수 있습니다. 다운로드 전 또는 다운로드 중에 리포지토리의 콘텐츠가 변조되지 않았는지 확인하기 위해 GPG(GNU Privacy Guard) 서명이 리포지토리의 메타데이터에 적용됩니다. 시스템에 올바른 퍼블릭 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
     ```

**참고**  
클라이언트에 설치를 완료하려면 컴퓨팅 인스턴스를 재부팅해야 할 수 있습니다.