기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 파일 시스템 액세스
Amazon FSx를 사용하면 Direct Connect 또는 VPN을 통해 데이터를 가져와 온프레미스에서 Amazon Web Services 클라우드로 컴퓨팅 집약적 워크로드를 버스트할 수 있습니다. 온프레미스에서 Amazon FSx 파일 시스템에 액세스하고, 필요에 따라 데이터를 파일 시스템으로 복사하고, 클라우드 내 인스턴스에서 컴퓨팅 집약적인 워크로드를 실행할 수 있습니다.
다음 섹션에서는 Linux 인스턴스에서 Amazon FSx for Lustre 파일 시스템에 액세스하는 방법을 알아볼 수 있습니다. 또한 파일 `fstab`를 사용하여 시스템을 다시 시작한 후 파일 시스템을 자동으로 다시 마운트하는 방법에 대해서도 알아볼 수 있습니다.
파일 시스템을 탑재하려면 관련 AWS 리소스를 만들고, 구성하고, 시작해야 합니다. 자세한 지침은 [Amazon FSx for Lustre 시작하기](getting-started.md) 섹션을 참조하세요. 다음으로 컴퓨팅 인스턴스에 Lustre 클라이언트를 설치하고 구성할 수 있습니다.
**Topics**
+ [
# Lustre 파일 시스템 및 클라이언트 커널 호환성
](lustre-client-matrix.md)
+ [
# Lustre 클라이언트 설치
](install-lustre-client.md)
+ [
# Amazon Elastic Compute Cloud 인스턴스에서 마운트
](mounting-ec2-instance.md)
+ [
# EFA 클라이언트 구성
](configure-efa-clients.md)
+ [
# Amazon Elastic Container Service에 마운트
](mounting-ecs.md)
+ [
# 온프레미스 또는 피어링된 Amazon VPC에서 Amazon FSx 파일 시스템 마운트
](mounting-on-premises.md)
+ [
# Amazon FSx 파일 시스템 자동 마운트
](mount-fs-auto-mount-onreboot.md)
+ [
# 특정 파일 세트 마운트
](mounting-from-fileset.md)
+ [
# 파일 시스템 탑재 해제
](unmounting-fs.md)
+ [
# Amazon EC2 스팟 인스턴스 작업
](working-with-ec2-spot-instances.md)
# Lustre 파일 시스템 및 클라이언트 커널 호환성
클라이언트 인스턴스의 Linux 커널 Lustre 버전과 호환되는 FSx for Lustre 파일 시스템의 버전을 사용하는 것이 좋습니다.
## Amazon Linux 클라이언트
| 운영 체제 | OS 버전 | 최소 커널 버전 | 최대 커널 버전 | Lustre 클라이언트 버전 | Lustre 파일 시스템 버전 |
| --- | --- | --- | --- | --- | --- |
| | | | | | 2.10 | 2.12 | 2.15 |
| Amazon Linux 2023 | 6.12 | \$1 | \$1 | 2.15 | 아니요 | 예 | 예 |
| | 6.1 | 6.1.79-99.167 | 6.1.79-99.167\$1 | 2.15 | 아니요 | 예 | 예 |
| Amazon Linux 2 | 5.10 | 5.10.144-127.601 | 5.10.144-127.601\$1 | 2.12 | 예 | 예 | 예 |
| | | | <5.10.144-127.601 | 2.10 | 예 | 예 | 아니요 |
| | 5.4 | 5.4.214-120.368 | 5.4.214-120.368\$1 | 2.12 | 예 | 예 | 예 |
| | | | <5.4.214-120.368 | 2.10 | 예 | 예 | 아니요 |
| | 4.14 | 4.14.294-220.533 | 4.14.294-220.533\$1 | 2.12 | 예 | 예 | 예 |
| | | | <4.14.294-220.533 | 2.10 | 예 | 예 | 아니요 |
## Ubuntu 클라이언트
| 운영 체제 | OS 버전 | 최소 커널 버전 | 최대 커널 버전 | Lustre 클라이언트 버전 | Lustre 파일 시스템 버전 |
| --- | --- | --- | --- | --- | --- |
| | | | | | 2.10 | 2.12 | 2.15 |
| Ubuntu | 24 | 6.14.0-1012 | 6.14.0\$1 | 2.15 | 아니요 | 예 | 예 |
| | | 6.8.0-1024 | 6.8.0\$1 | 2.15 | 아니요 | 예 | 예 |
| | 22 | 6.8.0-1017 | 6.8.0\$1 | 2.15 | 아니요 | 예 | 예 |
| | | 6.5.0-1023 | 6.5.0\$1 | 2.15 | 아니요 | 예 | 예 |
| | | 6.2.0-1017 | 6.2.0\$1 | 2.15 | 아니요 | 예 | 예 |
| | | 5.15.0-1015-aws | 5.15.0-1051-aws | 2.12 | 예 | 예 | 예 |
| | 20 | 5.15.0-1015-aws | 5.15.0\$1 | 2.12 | 예 | 예 | 예 |
| | | 5.4.0-1011-aws | 5.13.0-1031-aws | 2.10 | 예 | 예 | 아니요 |
## RHEL/CentOS/Rocky Linux 클라이언트
| 운영 체제 | OS 버전 | 아키텍처 | 최소 커널 버전 | 최대 커널 버전 | Lustre 클라이언트 버전 | Lustre 파일 시스템 버전 |
| --- | --- | --- | --- | --- | --- | --- |
| | | | | | | 2.10 | 2.12 | 2.15 |
| RHEL/Rocky Linux | 9.7 | Arm \$1 x86 | 5.14.0-611.5.1 | 5.14.0-611\$1 | 2.15 | 아니요 | 예 | 예 |
| | 9.6 | Arm \$1 x86 | 5.14.0-570.12.1 | 5.14.0-570\$1 | 2.15 | 아니요 | 예 | 예 |
| | 9.5 | Arm \$1 x86 | 5.14.0-503.19.1 | 5.14.0-503\$1 | 2.15 | 아니요 | 예 | 예 |
| | 9.4 | Arm \$1 x86 | 5.14.0-427.13.1 | 5.14.0-427\$1 | 2.15 | 아니요 | 예 | 예 |
| | 9.3 | Arm \$1 x86 | 5.14.0-362.18.1 | 5.14.0-362.18.1 | 2.15 | 아니요 | 예 | 예 |
| | 9.0 | Arm \$1 x86 | 5.14.0-70.13.1 | 5.14.0-70.30.1 | 2.15 | 아니요 | 예 | 예 |
| RHEL/CentOS/Rocky Linux | 8.10 | Arm \$1 x86 | 4.18.0-553 | 4.18.0-553\$1 | 2.12 | 예 | 예 | 예 |
| | 8.9 | Arm \$1 x86 | 4.18.0-513\$1 | 4.18.0-513\$1 | 2.12 | 예 | 예 | 예 |
| | 8.8 | Arm \$1 x86 | 4.18.0-477\$1 | 4.18.0-477\$1 | 2.12 | 예 | 예 | 예 |
| | 8.7 | Arm \$1 x86 | 4.18.0-425\$1 | 4.18.0-425\$1 | 2.12 | 예 | 예 | 예 |
| | 8.6 | Arm \$1 x86 | 4.18.0-372\$1 | 4.18.0-372\$1 | 2.12 | 예 | 예 | 예 |
| | 8.5 | Arm \$1 x86 | 4.18.0-348\$1 | 4.18.0-348\$1 | 2.12 | 예 | 예 | 예 |
| | 8.4 | Arm \$1 x86 | 4.18.0-305\$1 | 4.18.0-305\$1 | 2.12 | 예 | 예 | 예 |
| RHEL/CentOS | 8.3 | Arm \$1 x86 | 4.18.0-240\$1 | 4.18.0-240\$1 | 2.10 | 예 | 예 | 아니요 |
| | 8.2 | Arm \$1 x86 | 4.18.0-193\$1 | 4.18.0-193\$1 | 2.10 | 예 | 예 | 아니요 |
| | 7.9 | x86 | 3.10.0-1160\$1 | 3.10.0-1160\$1 | 2.12 | 예 | 예 | 예 |
| | 7.8 | x86 | 3.10.0-1127\$1 | 3.10.0-1127\$1 | 2.10 | 예 | 예 | 아니요 |
| | 7.7 | x86 | 3.10.0-1062\$1 | 3.10.0-1062\$1 | 2.10 | 예 | 예 | 아니요 |
| CentOS | 7.9 | Arm | 4.18.0-193\$1 | 4.18.0-193\$1 | 2.12 | 예 | 예 | 예 |
| | 7.8 | Arm | 4.18.0-147\$1 | 4.18.0-147\$1 | 2.12 | 예 | 예 | 예 |
# Lustre 클라이언트 설치
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
### Amazon Linux 2023에 Lustre 클라이언트를 설치하려면
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 클라이언트를 설치하려면
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 클라이언트를 설치하려면
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
### Red Hat 및 Rocky Linux 9.0 또는 9.3\$19.7에 Lustre 클라이언트를 설치하려면
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 이상)
앞의 명령은 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\$18.10 또는 Rocky Linux 8.4\$18.10에 Lustre 클라이언트를 설치하려면
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 또는 그 이상)
앞의 명령은 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 클라이언트 설치
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 이상)
앞의 명령은 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 기반 인스턴스)
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)
앞의 명령은 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
### 기본 페이지 크기(4KB)로 Ubuntu 18.04, 20.04, 22.04 또는 24.04에 Lustre 클라이언트를 설치하려면
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) 섹션을 참조하세요.
### 누락된 모듈 오류 해결 방법
임의의 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
### 6Ubuntu2464KB)에 Lustre 클라이언트를 설치하려면ARM64
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
### SUSE Linux 12 SP3, SP4 또는 SP5에 Lustre 클라이언트 설치
**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
```
**참고**
클라이언트에 설치를 완료하려면 컴퓨팅 인스턴스를 재부팅해야 할 수 있습니다.
# Amazon Elastic Compute Cloud 인스턴스에서 마운트
Amazon EC2 인스턴스에서 파일 시스템을 마운트할 수 있습니다.
**Amazon EC2에서 파일 시스템 마운트**
1. Amazon EC2 인스턴스에 연결합니다.
1. 다음 명령으로 FSx for Lustre 파일 시스템에 마운트 지점에 대한 디렉터리를 만드세요.
```
$ sudo mkdir -p /fsx
```
1. Amazon FSx for Lustre 파일 시스템을 생성한 디렉터리에 마운트합니다. 다음 명령을 사용하여 다음 항목을 바꿉니다.
+ `file_system_dns_name`을 실제 파일 시스템의 DNS 이름으로 바꿉니다.
+ `mountname`을 파일 시스템의 마운트 이름으로 바꿉니다. 이 마운트 이름은 `CreateFileSystem` API 작업 응답에 반환됩니다. **describe-file-systems** AWS CLI 명령 및 [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) API 작업의 응답으로도 반환됩니다.
```
sudo mount -t lustre -o relatime,flock file_system_dns_name@tcp:/mountname /fsx
```
이 명령은 `-o relatime`과 `flock` 같은 두 가지 옵션을 사용하여 파일 시스템을 마운트합니다.
+ `relatime` - `atime` 옵션은 파일에 액세스할 때마다 `atime`(inode 액세스 시간) 데이터를 유지하는 반면, `relatime` 옵션은 `atime` 데이터를 유지하지만 파일에 액세스할 때마다 매번 유지하지는 않습니다. `relatime` 옵션을 활성화하면 `atime` 데이터가 마지막으로 업데이트된 이후 파일이 수정된 경우(`mtime`) 또는 특정 시간 이상 전에 파일을 마지막으로 액세스한 경우(기본값 6시간)에만 `atime` 데이터가 디스크에 기록됩니다. `relatime` 또는 `atime` 옵션 중 하나를 사용하면 [파일 릴리스](file-release.md) 프로세스가 최적화됩니다.
**참고**
정확한 액세스 시간 정확도가 필요한 워크로드의 경우 `atime` 마운트 옵션을 사용하여 마운트할 수 있습니다. 하지만 이렇게 하면 정확한 액세스 시간 값을 유지하는 데 필요한 네트워크 트래픽이 증가하여 워크로드 성능에 영향을 미칠 수 있습니다.
워크로드에 메타데이터 액세스 시간이 필요하지 않은 경우 `noatime` 마운트 옵션을 사용하여 액세스 시간 업데이트를 비활성화하면 성능이 향상될 수 있습니다. 파일 릴리스나 데이터 유효성 공개와 같은 `atime` 집중 프로세스는 릴리스에서 정확하지 않을 수 있다는 점에 유의하세요.
+ `flock` - 파일 시스템의 파일 잠금을 활성화합니다. 파일 잠금을 활성화하지 않으려면 `flock`을 제외한 `mount` 명령을 사용합니다.
1. 다음 명령을 사용하여 파일 시스템을 마운트한 디렉터리인 /mnt/fsx의 내용을 나열하여 마운트 명령이 제대로 실행되었는지 확인합니다.
```
$ ls /fsx
import-path lustre
$
```
다음 `df` 명령도 사용할 수 있습니다.
```
$ df
Filesystem 1K-blocks Used Available Use% Mounted on
devtmpfs 1001808 0 1001808 0% /dev
tmpfs 1019760 0 1019760 0% /dev/shm
tmpfs 1019760 392 1019368 1% /run
tmpfs 1019760 0 1019760 0% /sys/fs/cgroup
/dev/xvda1 8376300 1263180 7113120 16% /
123.456.789.0@tcp:/mountname 3547698816 13824 3547678848 1% /fsx
tmpfs 203956 0 203956 0% /run/user/1000
```
결과는 /fsx에 마운트된 Amazon FSx 파일 시스템을 보여줍니다.
# EFA 클라이언트 구성
다음 절차에 따라 Elastic Fabric Adapter(EFA)를 통해 FSx for Lustre 파일 시스템에 액세스하도록 Lustre 클라이언트를 설정합니다.
EFA는 다음 운영 체제를 실행하는 Lustre 클라이언트에서 지원됩니다.
+ Amazon Linux 2023(AL2023)
+ RHEL(Red Hat Enterprise Linux) 9.5 이상
+ 커널 6.8\$1이상의 Ubuntu 22.04 이상
EFA는 아래 나열된 Lustre 클라이언트에서 지원됩니다. 자세한 내용은 [Lustre 클라이언트 설치](install-lustre-client.md) 단원을 참조하십시오.
EFA는 EFA를 지원하는 Nitro v4 이상 EC2 인스턴스에서 지원됩니다(trn2 인스턴스 패밀리 제외). *Amazon EC2 사용 설명서*의 [지원되는 인스턴스 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types)을 참조하세요.
**Topics**
+ [
## 1단계: 필수 드라이버 설치
](#install-required-drivers)
+ [
## 2단계: Lustre 클라이언트에 대해 EFA 구성
](#install-efa-on-client)
+ [
## 3단계: EFA 인터페이스
](#add-efa-interfaces)
## 1단계: 필수 드라이버 설치
**참고**
[딥 러닝 AMI](https://docs.aws.amazon.com/dlami/latest/devguide/what-is-dlami.html)를 사용하는 경우 Lustre 클라이언트, EFA 드라이버 및 NVIDIA GPUDirect 스토리지(GDS) 드라이버가 사전 설치되어 있으므로이 단계를 건너뛸 수 있습니다.
### Lustre 클라이언트 및 EFA 드라이버 설치
**Lustre 클라이언트 및 EFA 드라이버를 빠르게 설치하려면**
1. 설치 스크립트가 포함된 파일을 다운로드하고 압축을 풉니다.
```
curl -O https://docs.aws.amazon.com/fsx/latest/LustreGuide/samples/install-fsx-lustre-client.zip
unzip install-fsx-lustre-client.zip
```
1. `install-fsx-lustre-client` 폴더로 변경하고 설치 스크립트를 실행합니다.
```
cd install-fsx-lustre-client
sudo ./bin/install-fsx-lustre-client.sh --install-lustre --install-efa
```
스크립트가 자동으로 다음을 수행합니다.
+ Lustre 클라이언트를 설치합니다.
+ EFA 드라이버를 설치합니다.
+ Lustre 클라이언트 및 EFA 드라이버 설치를 확인합니다.
`install-fsx-lustre-client.sh` 스크립트에 사용할 수 있는 옵션 및 사용 예제 목록은 zip 파일의 `README.md` 파일을 참조하세요.
### GDS 드라이버 설치(선택 사항)
이 단계는 FSx for Lustre와 함께 NVIDIA GPUDirect Storage(GDS)를 사용하려는 경우에만 필요합니다.
요구 사항:
+ Amazon EC2 P5, P5e, P5en 또는 P6-B200 인스턴스
+ NVIDIA GDS 드라이버 버전 2.24.2 이상
**클라이언트 인스턴스에 NVIDIA GPUDirect Storage 드라이버 설치**
1. NVIDIA GDS 리포지토리를 복제합니다.
```
git clone https://github.com/NVIDIA/gds-nvidia-fs.git
```
1. 드라이버를 빌드하고 설치합니다.
```
cd gds-nvidia-fs/src/
export NVFS_MAX_PEER_DEVS=128
export NVFS_MAX_PCI_DEPTH=16
sudo -E make
sudo insmod nvidia-fs.ko
```
## 2단계: Lustre 클라이언트에 대해 EFA 구성
EFA 인터페이스를 사용하여 FSx for Lustre 파일 시스템에 액세스하려면 Lustre EFA 모듈을 설치하고 EFA 인터페이스를 구성해야 합니다.
### 빠른 설정
**Lustre 클라이언트를 빠르게 구성하는 방법**
1. Amazon EC2 인스턴스에 연결합니다.
1. 구성 스크립트가 포함된 파일을 다운로드하고 압축을 풉니다.
```
curl -O https://docs.aws.amazon.com/fsx/latest/LustreGuide/samples/configure-efa-fsx-lustre-client.zip
unzip configure-efa-fsx-lustre-client.zip
```
1. `configure-efa-fsx-lustre-client` 폴더로 변경하고 설정 스크립트를 실행합니다.
```
cd configure-efa-fsx-lustre-client
# for regular IO
sudo ./setup.sh
# for NVIDIA GPUDirect Storage (GDS) IO
sudo ./setup.sh --optimized-for-gds
```
스크립트가 자동으로 다음을 수행합니다.
+ Lustre 모듈을 가져옵니다.
+ TCP 및 EFA 인터페이스를 구성합니다.
+ 재부팅 시 자동 구성을 위한 시스템 서비스를 생성합니다.
`setup.sh` 스크립트에 사용할 수 있는 옵션 및 사용 예제 목록은 zip 파일의 `README.md` 파일을 참조하세요.
### 수동으로 systemd 서비스 관리
systemd 서비스 파일은 /etc/systemd/system/configure-efa-fsx-lustre-client.service에 생성됩니다. 다음은 몇 가지 유용한 systemd 관련 명령입니다.
```
# Check status
sudo systemctl status configure-efa-fsx-lustre-client.service
# View logs
sudo journalctl -u configure-efa-fsx-lustre-client.service
# View warnings/errors from dmesg
sudo dmesg
```
자세한 내용은 zip 파일의 `README.md` 파일을 참조하세요.
### 자동 마운트 구성(선택 사항)
Amazon FSx for Lustre 파일 시스템을 자동으로 마운팅하는 방법에 대한 자세한 내용은 [Amazon FSx 파일 시스템 자동 마운트](mount-fs-auto-mount-onreboot.md) 섹션을 참조하세요.
## 3단계: EFA 인터페이스
각 FSx for Lustre 파일 시스템에는 모든 클라이언트 인스턴스에 걸쳐 최대 1,024개의 EFA 연결 제한이 있습니다.
`configure-efa-fsx-lustre-client.sh` 스크립트는 인스턴스 유형에 따라 EFA 인터페이스를 자동으로 구성합니다.
| 인스턴스 유형 | 기본 EFA 인터페이스 수 |
| --- | --- |
| p6e-gb200.36xlarge | 8 |
| p6-b200.48xlarge | 8 |
| p5en.48xlarge | 8 |
| p5e.48xlarge | 8 |
| p5.48xlarge | 8 |
| 네트워크 카드가 여러 개인 기타 인스턴스 | 2 |
| 네트워크 카드가 하나인 기타 인스턴스 | 1 |
클라이언트 인스턴스에 구성된 각 EFA 인터페이스는 FSx for Lustre 파일 시스템에 연결될 때 1,024개의 EFA 연결 한도에 대해 하나의 연결로 계산됩니다.
### 수동으로 EFA 인터페이스 관리
EFA 인터페이스가 더 많은 인스턴스는 일반적으로 더 높은 처리량을 지원합니다. 총 EFA 연결 한도 이내에서 인터페이스 수를 사용자 지정하여 특정 워크로드의 성능을 최적화할 수 있습니다.
다음 명령을 사용하여 EFA 인터페이스를 수동으로 관리할 수 있습니다.
1. 사용 가능한 EFA 인터페이스 보기:
```
for interface in /sys/class/infiniband/*; do
if [ ! -e "$interface/device/driver" ]; then continue; fi
driver=$(basename "$(realpath "$interface/device/driver")")
if [ "$driver" != "efa" ]; then continue; fi
echo $(basename $interface)
done
```
1. 현재 구성된 인터페이스 보기:
```
sudo lnetctl net show
```
1. EFA 인터페이스 추가:
```
sudo lnetctl net add --net efa --if device_name --peer-credits 32
```
*device\$1name*을 1단계의 목록에 있는 실제 디바이스 이름으로 바꿉니다.
1. EFA 인터페이스 제거:
```
sudo lnetctl net del --net efa --if device_name
```
*device\$1name*을 2단계의 목록에 있는 실제 디바이스 이름으로 바꿉니다.
# Amazon Elastic Container Service에 마운트
Amazon EC2 인스턴스의 Amazon Elastic Container Service(Amazon ECS) 도커 컨테이너에서 FSx for Lustre 파일 시스템에 액세스할 수 있습니다. 다음 두 가지 옵션 중 하나를 사용할 수 있습니다.
1. Amazon ECS 작업을 호스팅하는 Amazon EC2 인스턴스에서 FSx for Lustre 파일 시스템을 마운트함으로써 해당 마운트 포인트를 컨테이너로 내보냅니다.
1. 파일 시스템을 작업 컨테이너 내에 직접 마운트합니다.
자세한 내용은 [Amazon Elastic Container Service 개발자 안내서](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html) 내 *Amazon Elastic Container Service란 무엇인가요?* 섹션을 참조하세요.
옵션 1([Amazon ECS 작업을 호스팅하는 Amazon EC2 인스턴스에서 마운트](#mounting-from-ecs-ec2))을 사용하는 것이 좋습니다. 동일한 EC2 인스턴스에서 여러 컨테이너(5개 이상)를 시작하거나 작업의 수명이 짧을 경우(5분 미만) 더 나은 리소스 사용량을 제공합니다.
EC2 인스턴스를 구성할 수 없거나 애플리케이션에 컨테이너의 유연성이 필요한 경우 옵션 2([도커 컨테이너에서 마운트](#mounting-from-docker))를 사용합니다.
**참고**
AWS Fargate 시작 유형에 FSx for Lustre를 탑재하는 것은 지원되지 않습니다.
다음 섹션에서는 Amazon ECS 컨테이너에서 FSx for Lustre 파일 시스템을 마운트하기 위한 각 옵션의 절차를 설명합니다.
**Topics**
+ [
## Amazon ECS 작업을 호스팅하는 Amazon EC2 인스턴스에서 마운트
](#mounting-from-ecs-ec2)
+ [
## 도커 컨테이너에서 마운트
](#mounting-from-docker)
## Amazon ECS 작업을 호스팅하는 Amazon EC2 인스턴스에서 마운트
이 절차는 FSx for Lustre 파일 시스템을 로컬 마운트하도록 EC2 인스턴스 기반 Amazon ECS를 구성하는 방법을 보여줍니다. 이 절차는 `volumes`와 `mountPoints` 컨테이너 속성을 사용하여 리소스를 공유하고 로컬 실행 작업에서 이 파일 시스템에 액세스할 수 있도록 합니다. 자세한 내용은 *Amazon Elastic Container Service 개발자 안내서*의 [Amazon ECS 컨테이너 인스턴스 시작](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_container_instance.html) 섹션을 참조하세요.
이 절차는 Amazon ECS 최적화 Amazon Linux 2 AMI용입니다. 다른 Linux 배포판을 사용하는 경우 [Lustre 클라이언트 설치](install-lustre-client.md) 섹션을 참조하세요.
**Amazon ECS에서 EC2 인스턴스에 파일 시스템 마운트**
1. 수동으로 또는 오토 스케일링 그룹을 사용하여 Amazon ECS 인스턴스를 시작할 때는 다음 코드 예제의 라인을 **사용자 데이터** 필드 끝에 추가합니다. 예제의 다음 항목들을 바꿉니다.
+ `file_system_dns_name`을 실제 파일 시스템의 DNS 이름으로 바꿉니다.
+ `mountname`을 파일 시스템의 마운트 이름으로 바꿉니다.
+ `mountpoint`를 생성해야 하는 파일 시스템의 마운트 지점으로 바꿉니다.
```
#!/bin/bash
......
fsx_dnsname=file_system_dns_name
fsx_mountname=mountname
fsx_mountpoint=mountpoint
amazon-linux-extras install -y lustre
mkdir -p "$fsx_mountpoint"
mount -t lustre ${fsx_dnsname}@tcp:/${fsx_mountname} ${fsx_mountpoint} -o relatime,flock
```
1. Amazon ECS 작업을 생성할 때 JSON 정의에 다음 `volumes` 및 `mountPoints` 컨테이너 속성을 추가합니다. `mountpoint`를 파일 시스템의 마운트 포인트(예:`/mnt/fsx`)로 대체합니다.
```
{
"volumes": [
{
"host": {
"sourcePath": "mountpoint"
},
"name": "Lustre"
}
],
"mountPoints": [
{
"containerPath": "mountpoint",
"sourceVolume": "Lustre"
}
],
}
```
## 도커 컨테이너에서 마운트
다음 절차는 `lustre-client` 패키지를 설치하고 FSx for Lustre 파일 시스템을 마운트하도록 Amazon ECS 작업 컨테이너를 구성하는 방법을 보여줍니다. 이 절차에서는 Amazon Linux(`amazonlinux`) 도커 이미지를 사용하지만 다른 배포판에서도 비슷한 접근 방식을 사용할 수 있습니다.
**도커 컨테이너에서 파일 시스템 마운트**
1. 도커 컨테이너에서 `lustre-client` 패키지를 설치하고 해당 속성을 사용하여 `command` 속성에 FSx for Lustre 파일 시스템을 마운트합니다. 예제의 다음 항목들을 바꿉니다.
+ `file_system_dns_name`을 실제 파일 시스템의 DNS 이름으로 바꿉니다.
+ `mountname`을 파일 시스템의 마운트 이름으로 바꿉니다.
+ `mountpoint`를 파일 시스템의 마운트 지점으로 바꿉니다.
```
"command": [
"/bin/sh -c \"amazon-linux-extras install -y lustre; mount -t lustre file_system_dns_name@tcp:/mountname mountpoint -o relatime,flock;\""
],
```
1. `linuxParameters` 속성을 사용하여 FSx for Lustre 파일 시스템을 마운트하도록 승인하는 `SYS_ADMIN` 기능을 컨테이너에 추가합니다.
```
"linuxParameters": {
"capabilities": {
"add": [
"SYS_ADMIN"
]
}
}
```
# 온프레미스 또는 피어링된 Amazon VPC에서 Amazon FSx 파일 시스템 마운트
다음 두 가지 방법으로 Amazon FSx 파일 시스템에 액세스할 수 있습니다. 하나는 파일 시스템의 VPC에 피어링된 Amazon VPC에 위치한 Amazon EC2 인스턴스에서 가져오는 방법입니다. 다른 하나는 Direct Connect 또는 VPN을 사용하여 파일 시스템의 VPC에 연결된 온프레미스 클라이언트에서 가져온 것입니다.
VPC 피어링 연결 또는 VPC 전송 게이트웨이를 사용하여 클라이언트의 VPC와 Amazon FSx 파일 시스템의 VPC를 연결합니다. VPC 피어링 연결 또는 전송 게이트웨이를 사용하여 VPC를 연결하면 VPC가 다른 계정에 속해 있더라도 하나의 VPC에 있는 Amazon EC2 인스턴스가 다른 VPC의 Amazon FSx 파일 시스템에 액세스할 수 있습니다.
다음 절차를 사용하기 전에 VPC 피어링 연결 또는 VPC 전송 게이트웨이를 설정해야 합니다.
전송 게이트웨이**는 VPC와 온프레미스 네트워크를 상호 연결하는 데 사용할 수 있는 네트워크 전송 허브입니다. VPC 전송 게이트웨이 사용에 대한 자세한 내용은 *Amazon VPC Transit Gateway 가이드*의 [전송 게이트웨이 시작하기](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-getting-started.html) 섹션을 참조하세요.
VPC 피어링 연결**은 두 VPC 간의 네트워킹 연결입니다. 이러한 유형의 연결을 사용하면 프라이빗 Internet Protocol version 4(IPv4) 또는 Internet Protocol version 6(IPv6) 주소를 사용하여 이들 간의 트래픽을 라우팅할 수 있습니다. VPC 피어링을 사용하여 동일한 AWS 리전 내에서 또는 AWS 리전 간에 VPCs를 연결할 수 있습니다. 자세한 내용은 *Amazon VPC 피어링 가이드*의 [VPC 피어링이란?](https://docs.aws.amazon.com/vpc/latest/peering/Welcome.html) 섹션을 참조하세요.
기본 네트워크 인터페이스의 IP 주소를 사용하여 VPC 외부에서 파일 시스템을 마운트할 수 있습니다. 기본 네트워크 인터페이스는 `aws fsx describe-file-systems` AWS CLI 명령을 실행할 때 반환되는 첫 번째 네트워크 인터페이스입니다. Amazon Web Services Management Console에서도 IP 주소를 얻을 수 있습니다.
다음 표는 파일 시스템의 VPC 외부에 있는 클라이언트를 사용하여 Amazon FSx 파일 시스템에 액세스하기 위한 IP 주소 요구 사항을 보여줍니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/fsx/latest/LustreGuide/mounting-on-premises.html)
프라이빗 IP 주소 범위를 사용하여 2020년 12월 17일 이전에 생성된 Amazon FSx 파일 시스템에 액세스해야 하는 경우, 파일 시스템의 백업을 복원하여 새 파일 시스템을 생성할 수 있습니다. 자세한 내용은 [백업으로 데이터 보호](using-backups-fsx.md) 단원을 참조하십시오.
**파일 시스템의 기본 네트워크 인터페이스의 IP 주소 검색**
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/)에서 Amazon FSx 콘솔을 엽니다.
1. 탐색 창에서 **파일 시스템**을 선택합니다.
1. 대시보드에서 파일 시스템을 선택합니다.
1. 파일 시스템 세부 정보 페이지에서 **네트워크 및 보안**을 선택합니다.
1. **네트워크 인터페이스**의 경우 기본 탄력적 네트워크 인터페이스의 ID를 선택합니다. 이렇게 하면 Amazon EC2 콘솔로 이동합니다.
1. **세부 정보** 탭에서 **기본 프라이빗 IPv4 IP**를 찾습니다. 해당 IP가 기본 네트워크 인터페이스의 IP 주소입니다.
**참고**
Amazon FSx 파일 시스템을 연결된 VPC 외부에서 마운트할 때는 도메인 이름 시스템(DNS) 이름 확인을 사용할 수 없습니다.
# Amazon FSx 파일 시스템 자동 마운트
인스턴스에 처음 연결한 후 Amazon EC2 인스턴스에서 `/etc/fstab` 파일을 업데이트하여 재부팅할 때마다 Amazon FSx 파일 시스템을 마운트하도록 할 수 있습니다.
## /etc/fstab 사용하여 FSx for Lustre 자동으로 마운트
Amazon EC2 인스턴스가 재부팅될 때마다 Amazon FSx 파일 시스템 디렉터리를 자동으로 마운트하도록 `fstab` 파일을 사용할 수 있습니다. `fstab` 파일에는 파일 시스템에 대한 정보가 들어 있습니다. 인스턴스 시작 중에 실행되는 `mount -a` 명령은 `fstab` 파일에 나열된 파일 시스템을 마운트합니다.
**참고**
EC2 인스턴스의 `/etc/fstab` 파일을 업데이트하려면 Amazon FSx 파일 시스템을 미리 만들어 두어야 합니다. 자세한 내용은 시작하기 연습의 [1단계: FSx for Lustre 파일 시스템 생성](getting-started.md#getting-started-step1) 섹션을 참조하세요.
EFA 지원 파일 시스템의 경우 systemd 구성은 사전 조건입니다. 자세한 내용은 [빠른 설정](configure-efa-clients.md#quick-setup) 단원을 참조하십시오.
**EC2 인스턴스의 /etc/fstab 파일 업데이트**
1. EC2 인스턴스를 연결하고 편집기에서 `/etc/fstab` 파일을 엽니다.
1. `/etc/fstab` 파일에 다음 줄을 추가합니다.
Amazon FSx for Lustre 파일 시스템을 생성한 디렉터리에 마운트합니다. 다음 명령을 사용하여 다음을 대체합니다.
+ Amazon FSx 파일 시스템을 마운트하려는 디렉터리로 *`/fsx`*을 대체합니다.
+ `file_system_dns_name`을 실제 파일 시스템의 DNS 이름으로 바꿉니다.
+ `mountname`을 파일 시스템의 마운트 이름으로 바꿉니다. 이 마운트 이름은 `CreateFileSystem` API 작업 응답에 반환됩니다. **describe-file-systems** AWS CLI 명령 및 `[DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html)` API 작업의 응답으로도 반환됩니다.
**EFA 미지원 파일 시스템의 경우:**
```
file_system_dns_name@tcp:/mountname /fsx lustre defaults,relatime,flock,_netdev,x-systemd.automount,x-systemd.requires=network.service 0 0
```
**EFA 지원 파일 시스템의 경우:**
```
file_system_dns_name@tcp:/mountname /fsx lustre defaults,relatime,flock,_netdev,x-systemd.automount,x-systemd.requires=configure-efa-fsx-lustre-client.service,x-systemd.after=configure-efa-fsx-lustre-client.service 0 0
```
**주의**
파일 시스템을 자동으로 마운트하는 경우 네트워크 파일 시스템 식별에 사용하는 `_netdev` 옵션을 사용합니다. `_netdev`이 빠진 경우 EC2 인스턴스가 응답을 중지합니다. 컴퓨팅 인스턴스가 네트워킹을 시작한 후 네트워크 파일 시스템의 초기화를 완료해야 하기 때문입니다. 자세한 내용은 [자동 마운트 실패 및 인스턴스 무응답](mount-troubleshooting.md#lustre-automount-fails) 단원을 참조하십시오.
1. 파일 변경 사항을 저장합니다.
이제 EC2 인스턴스가 다시 시작될 때마다 Amazon FSx 파일 시스템을 마운트하도록 구성되었습니다.
**참고**
경우에 따라 마운트된 Amazon FSx 파일 시스템의 상태와 관계없이 Amazon EC2 인스턴스를 시작해야 할 수 있습니다. 이 경우 `/etc/fstab` 파일의 파일 시스템 항목에 `nofail` 옵션을 추가합니다.
`/etc/fstab` 파일에 추가한 코드 줄은 다음 작업을 수행합니다.
| 필드 | 설명 |
| --- | --- |
| `file_system_dns_name@tcp:/` | 파일 시스템을 식별하는 Amazon FSx 파일 시스템의 DNS 이름입니다. 콘솔에서 또는 또는 SDK에서 프로그래밍 방식으로이 이름을 가져올 수 AWS CLI 있습니다 AWS . |
| `mountname` | 파일 시스템에 대한 마운트 이름입니다. 이 이름은 콘솔에서 가져오거나 **describe-file-systems** 명령을 AWS CLI 사용하여에서 프로그래밍 방식으로 가져오거나 `[DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html)` 작업을 사용하여 AWS API 또는 SDK에서 가져올 수 있습니다. |
| `/fsx` | EC2 인스턴스의 Amazon FSx 파일 시스템 마운트 지점 |
| `lustre` | Amazon FSx 파일 시스템 유형 |
| `mount options` | 파일 시스템의 마운트 옵션은 쉼표로 구분된 다음 옵션 목록에 표시됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/fsx/latest/LustreGuide/mount-fs-auto-mount-onreboot.html) |
| `x-systemd.automount,x-systemd.requires=network.service` | EFA 미지원 파일 시스템에 대해 이러한 옵션을 사용하면 네트워크 연결이 온라인 상태가 될 때까지 자동 마운터가 실행되지 않습니다. Amazon Linux 2023 및 Ubuntu 22.04 이상의 경우 `x-systemd.requires=network.service` 옵션 대신 `x-systemd.requires=systemd-networkd-wait-online.service` 옵션을 사용합니다. |
| `x-systemd.automount,x-systemd.requires=configure-efa-fsx-lustre-client.service,x-systemd.after=configure-efa-fsx-lustre-client.service` | EFA 지원 파일 시스템에 대해 이러한 옵션을 사용하면 EFA 클라이언트 구성이 완료될 때까지 자동 마운터가 실행되지 않습니다. |
| `0` | 파일 시스템을 `dump`으로 백업해야 하는지 나타내는 값. Amazon FSx의 경우 이 값은 `0`이어야 합니다. |
| `0` | 부팅 시 `fsck`가 파일을 체크하는 순서를 나타내는 값. Amazon FSx 파일 시스템의 경우 이 값을 `0`으로 하여 시작 시 `fsck`가 실행되지 않도록 해야 합니다. |
# 특정 파일 세트 마운트
Lustre 파일 세트 기능을 사용하면 파일 시스템 네임스페이스의 일부만 마운트할 수 있으며, 이를 *파일 세트*라고 합니다. 파일 시스템의 파일 세트를 마운트하려면 클라이언트에서 파일 시스템 이름 뒤에 하위 디렉터리 경로를 지정합니다. 파일 세트 마운트(하위 디렉터리 마운트라고도 함)는 특정 클라이언트의 파일 시스템 네임스페이스 가시성을 제한합니다.
**예제 - Lustre 파일 세트 탑재**
1. 다음 디렉터리가 있는 FSx for Lustre 파일 시스템이 있다고 가정해 보겠습니다.
```
team1/dataset1/
team2/dataset2/
```
1. `team1/dataset1` 파일 세트만 마운트하면 파일 시스템의 이 부분만 클라이언트에 로컬로 표시됩니다. 다음 명령을 사용하여 다음 항목을 바꿉니다.
+ `file_system_dns_name`을 실제 파일 시스템의 DNS 이름으로 바꿉니다.
+ `mountname`을 파일 시스템의 마운트 이름으로 바꿉니다. 이 마운트 이름은 `CreateFileSystem` API 작업 응답에 반환됩니다. **describe-file-systems** AWS CLI 명령 및 [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) API 작업의 응답으로도 반환됩니다.
```
mount -t lustre file_system_dns_name@tcp:/mountname/team1/dataset1 /fsx
```
Lustre 파일 세트 기능을 사용할 때 다음 사항에 유의하세요.
+ 클라이언트가 다른 파일 세트를 사용하거나 파일 세트를 전혀 사용하지 않고 파일 시스템을 다시 마운트하지 못하도록 하는 제약 조건은 없습니다.
+ 파일 세트를 사용할 경우 `lfs fid2path` 명령과 같은 `.lustre/` 디렉터리 액세스가 필요한 일부 Lustre 관리 명령이 작동하지 않을 수 있습니다.
+ 동일한 파일 시스템의 여러 하위 디렉터리를 동일한 호스트에 마운트하려는 경우, 이 경우 단일 마운트 지점보다 많은 리소스가 소모되므로 파일 시스템 루트 디렉터리를 한 번만 마운트하는 것이 더 효율적일 수 있다는 점을 유의하세요.
Lustre 파일 세트 기능에 대한 자세한 내용은 [Lustre 설명서 웹 사이트](https://doc.lustre.org/lustre_manual.xhtml#SystemConfigurationUtilities.fileset)의 *Lustre 운영 매뉴얼*을 참조하세요.
# 파일 시스템 탑재 해제
FSx for Lustre 파일 시스템을 삭제하기 전에 해당 파일 시스템을 마운트한 모든 Amazon EC2 인스턴스에서 마운트를 해제하고, Amazon EC2 인스턴스를 중지하거나 종료하기 전에 마운트된 FSx for Lustre 파일 시스템이 해당 인스턴스에서 해제되었는지 확인합니다.
FSx for Lustre 서버는 I/O 작업 중에 클라이언트에 임시 파일 및 디렉터리 잠금 권한을 부여하며, 클라이언트는 서버가 클라이언트에게 잠금을 해제하여 다른 클라이언트의 I/O 작업에 대한 차단을 해제하도록 요청할 때 즉시 응답해야 합니다. 클라이언트가 응답하지 않게 되면 몇 분 후에 다른 클라이언트가 요청된 I/O 작업을 진행할 수 있도록 해당 클라이언트가 강제로 제거됩니다. 이러한 대기 기간을 방지하려면 클라이언트 인스턴스를 중지하거나 종료하기 전에, 그리고 FSx for Lustre 파일 시스템을 삭제하기 전에 항상 클라이언트 인스턴스에서 파일 시스템의 마운트를 해제해야 합니다.
인스턴스 자체에서 `umount` 명령을 실행하여 Amazon EC2 인스턴스에서 파일 시스템의 탑재를 해제할 수 있습니다. AWS CLI AWS Management Console, 또는 AWS SDKs를 통해 Amazon FSx 파일 시스템의 탑재를 해제할 수 없습니다. Linux를 실행하는 Amazon EC2 인스턴스에 연결된 Amazon FSx 파일 시스템을 마운트 해제하려면 다음과 같이 `umount` 명령을 사용합니다.
```
umount /mnt/fsx
```
다른 `umount` 옵션은 지정하지 않는 것이 좋습니다. 기본값과 다른 그 밖의 `umount` 옵션은 설정하지 않는 것이 좋습니다.
`df` 명령을 실행하여 Amazon FSx 파일 시스템이 마운트 해제되었는지 확인할 수 있습니다. 이 명령은 Linux 기반 Amazon EC2 인스턴스에 현재 마운트된 파일 시스템에 대한 디스크 사용량 통계를 표시합니다. 마운트 해제하려는 Amazon FSx 파일 시스템이 `df` 명령 출력에 나열되어 있지 않으면 그 파일 시스템은 마운트 해제된 것입니다.
**Example - Amazon FSx 파일 시스템의 마운트 상태 식별 및 마운트 해제**
```
$ df -T
Filesystem Type 1K-blocks Used Available Use% Mounted on
file-system-id.fsx.aws-region.amazonaws.com@tcp:/mountname /fsx 3547708416 61440 3547622400 1% /fsx
/dev/sda1 ext4 8123812 1138920 6884644 15% /
```
```
$ umount /fsx
```
```
$ df -T
```
```
Filesystem Type 1K-blocks Used Available Use% Mounted on
/dev/sda1 ext4 8123812 1138920 6884644 15% /
```
# Amazon EC2 스팟 인스턴스 작업
FSx for Lustre를 EC2 스팟 인스턴스와 함께 사용하면 Amazon EC2 비용을 크게 낮출 수 있습니다. 스팟 인스턴스는 온디맨드 가격보다 저렴한 비용으로 제공되는 미사용 EC2 인스턴스입니다. Amazon EC2는 스팟 인스턴스에 대한 수요가 증가하거나 스팟 인스턴스의 공급이 감소하거나 스팟 가격이 최고가를 초과하는 경우 스팟 인스턴스를 중단할 수 있습니다.
Amazon EC2는 스팟 인스턴스를 중단할 때 스팟 인스턴스 중단 공지를 보내 중단 2분 전에 이를 인스턴스에 경고합니다. 자세한 내용은 *Amazon EC2 사용 설명서*의 [스팟 인스턴스](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html)를 참조하세요.
Amazon FSx 파일 시스템이 EC2 스팟 인스턴스 중단의 영향을 받지 않도록 EC2 스팟 인스턴스를 종료하거나 최대 절전 모드로 전환하기 전에 Amazon FSx 파일 시스템을 마운트 해제하는 것이 좋습니다. 자세한 내용은 [파일 시스템 탑재 해제](unmounting-fs.md) 섹션을 참조하세요.
## Amazon EC2 스팟 인스턴스 중단 처리
FSx for Lustre는 서버와 클라이언트 인스턴스가 협력하여 성능이 뛰어나고 안정적인 파일 시스템을 제공하는 분산 파일 시스템입니다. 클라이언트와 서버 인스턴스 모두에서 분산되고 일관된 상태를 유지합니다. FSx for Lustre 서버는 클라이언트가 I/O를 활발히 수행하고 파일 시스템 데이터를 캐싱하는 동안 임시 액세스 권한을 클라이언트에 위임합니다. 서버가 임시 액세스 권한을 취소하도록 요청하면 클라이언트는 짧은 시간 내에 응답할 것으로 예상됩니다. 오작동하는 클라이언트로부터 파일 시스템을 보호하기 위해 서버는 몇 분 후에도 응답하지 않는 Lustre 클라이언트를 제거할 수 있습니다. 응답하지 않는 클라이언트가 서버 요청에 응답할 때까지 몇 분 동안 기다릴 필요가 없도록 하려면 EC2 스팟 인스턴스를 종료하기 전에 Lustre 클라이언트를 완전히 마운트 해제하는 것이 중요합니다.
EC2 스팟은 인스턴스를 종료하기 2분 전에 종료 알림을 보냅니다. EC2 스팟 인스턴스를 종료하기 전에 Lustre 클라이언트를 완전히 마운트 해제하는 프로세스를 자동화하는 것이 좋습니다.
**Example - 종료된 EC2 스팟 인스턴스를 완전히 마운트 해제하기 위한 스크립트**
이 예제 스크립트는 다음을 수행하여 종료된 EC2 스팟 인스턴스를 완전히 마운트 해제합니다.
+ 스팟 종료 알림에 유의하세요.
+ 종료 통지를 받는 경우
+ 파일 시스템에 액세스하는 애플리케이션을 중지합니다.
+ 인스턴스가 종료되기 전에 파일 시스템을 마운트 해제합니다.
특히 애플리케이션을 정상적으로 종료하는 경우 필요에 따라 스크립트를 조정할 수 있습니다. 스팟 인스턴스 중단 처리 모범 사례에 대한 자세한 내용은 [EC2 스팟 인스턴스 중단 처리 모범 사례](https://aws.amazon.com/blogs//compute/best-practices-for-handling-ec2-spot-instance-interruptions/)를 참조하세요.
```
#!/bin/bash
# TODO: Specify below the FSx mount point you are using
*FSXPATH=/fsx*
cd /
TOKEN=$(curl -s -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600")
if [ "$?" -ne 0 ]; then
echo "Error running 'curl' command" >&2
exit 1
fi
# Periodically check for termination
while sleep 5
do
HTTP_CODE=$(curl -H "X-aws-ec2-metadata-token: $TOKEN" -s -w %{http_code} -o /dev/null http://169.254.169.254/latest/meta-data/spot/instance-action)
if [[ "$HTTP_CODE" -eq 401 ]] ; then
# Refreshing Authentication Token
TOKEN=$(curl -s -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 30")
continue
elif [[ "$HTTP_CODE" -ne 200 ]] ; then
# If the return code is not 200, the instance is not going to be interrupted
continue
fi
echo "Instance is getting terminated. Clean and unmount '$FSXPATH' ..."
curl -H "X-aws-ec2-metadata-token: $TOKEN" -s http://169.254.169.254/latest/meta-data/spot/instance-action
echo
# Gracefully stop applications accessing the filesystem
#
# TODO*: Replace with the proper command to stop your application if possible*
# Kill every process still accessing Lustre filesystem
echo "Kill every process still accessing Lustre filesystem..."
fuser -kMm -TERM "${FSXPATH}"; sleep 2
fuser -kMm -KILL "${FSXPATH}"; sleep 2
# Unmount FSx For Lustre filesystem
if ! umount -c "${FSXPATH}"; then
echo "Error unmounting '$FSXPATH'. Processes accessing it:" >&2
lsof "${FSXPATH}"
echo "Retrying..."
continue
fi
# Start a graceful shutdown of the host
shutdown now
done
```