Amazon FSx for NetApp ONTAP을 생성 및 실행하면서 막혔던 포인트를 정리해 봤습니다.
안녕하세요 클래스메소드 김재욱(Kim Jaewook) 입니다. 이번 블로그에서는 Amazon FSx for NetApp ONTAP을 생성 및 실행하면서 막혔던 포인트를 정리해 봤습니다.
FlexCache 생성 시 에러
처음에 -aggr-list 옵션 없이 아래 명령어를 실행했습니다.
volume flexcache create -vserver svm_test -volume vol_cadtool_cache -origin-vserver svm_test -origin-volume vol_cadtool -size 100g -junction-path /vol_cadtool_cache
그러자 다음과 같은 에러가 발생했습니다.
[Job 46] Job is queued: Create FlexCache volume vol_cadtool_cache..
Error: command failed: [Job 46] Job failed: No suitable storage can be found for the specified requirements.
Aggregates not matching FabricPool requirements: aggr1
원인을 파악하기 위해 사용 가능한 애그리게이트를 확인했습니다.
storage aggregate show
실행 결과
Aggregate Size Available Used% State #Vols Nodes RAID Status
--------- -------- --------- ----- ------- ------ ---------------- ------------
aggr1 907.0GB 905.0GB 0% online 3 FsxIdxxxxxxxxxxx raid0,
9a5238-01 normal
애그리게이트는 aggr1 하나뿐이었습니다. FSx Single-AZ 환경에서는 FlexCache 생성 시 FabricPool 지원 애그리게이트가 필요한데, 자동으로 찾지 못하는 경우가 있습니다. -aggr-list 옵션으로 애그리게이트를 명시적으로 지정해서 해결했습니다.
volume flexcache create -vserver svm_test -volume vol_cadtool_cache -origin-vserver svm_test -origin-volume vol_cadtool -size 100g -junction-path /vol_cadtool_cache -aggr-list aggr1
실행 결과
[Job 47] Creating FlexCache volume
[Job 47] Job succeeded: Successful.
ONTAP CLI SSH 접속이 안 될 때
아래 명령어로 ONTAP CLI에 SSH 접속을 시도했습니다.
ssh fsxadmin@management.fs-xxxxxxxxxxxx.fsx.ap-northeast-1.amazonaws.com
그런데 프롬프트가 뜨지 않고 그대로 멈췄습니다.
ssh fsxadmin@management.fs-xxxxxxxxxxxxxxxxx.fsx.ap-northeast-1.amazonaws.com
(커서가 멈춘 채로 무반응)
원인은 FSx의 보안 그룹에 SSH 22번 포트 인바운드 규칙이 없었기 때문입니다. FSx 보안 그룹에 아래 규칙을 추가하고 Ctrl+C로 끊은 뒤 다시 시도했습니다.
| 유형 | 포트 | 소스 |
|---|---|---|
| SSH | 22 (TCP) | EC2 보안 그룹 ID |
보안 그룹 추가 후 재접속하자 정상적으로 접속됐습니다.
ssh fsxadmin@management.fs-xxxxxxxxxxxxxxxxx.fsx.ap-northeast-1.amazonaws.com
The authenticity of host 'management.fs-xxxxxxxxxxxxxxxxx.fsx.ap-northeast-1.amazonaws.com (x.x.x.x)' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'management.fs-xxxxxxxxxxxxxxxxx.fsx.ap-northeast-1.amazonaws.com' (ED25519) to the list of known hosts.
(fsxadmin@management.fs-xxxxxxxxxxxxxxxxx.fsx.ap-northeast-1.amazonaws.com) Password:
This is your first recorded login.
FsxIdxxxxxxxxxxxxxxxxx::>
fsxadmin / vsadmin 암호 미설정 에러
FSx 생성 시 암호 입력란을 비워두거나 7자 이하로 입력하면 아래 validation 에러가 발생하며 생성이 실패합니다.
2 validation errors detected:
Value at 'ontapConfiguration.fsxAdminPassword' failed to satisfy constraint:
Member must have length greater than or equal to 8;
Value at 'ontapConfiguration.fsxAdminPassword' failed to satisfy constraint:
Member must satisfy regular expression pattern: ^[^�
]{8,50}$
에러가 두 번 발생한 이유는 fsxadmin(파일시스템 관리자) 과 vsadmin(SVM 관리자) 암호를 각각 설정해야 하는데, 둘 다 입력하지 않았기 때문입니다. 설정 화면에서 각각의 암호 입력란을 찾아 8자 이상으로 설정하면 해결됩니다.
암호 조건:
- 8자 이상 50자 이하
- 줄바꿈 및 제어문자 불가
- 영문 대소문자 + 숫자 + 특수문자 조합 권장 (예:
Fsx@Test2026)
마무리
이번 글에서는 Amazon FSx for NetApp ONTAP을 구성하면서 실제로 마주했던 문제와 해결 방법을 정리해 봤습니다.
가장 시간을 들였던 부분은 FlexCache 생성 시 발생한 애그리게이트 관련 에러였습니다. 에러 메시지만으로는 원인을 파악하기 쉽지 않았지만, 사용 가능한 애그리게이트를 확인하고 -aggr-list 옵션으로 명시적으로 지정하면서 문제를 해결할 수 있었습니다. 또한 ONTAP CLI에 SSH로 접속할 때는 보안 그룹에 SSH(22) 인바운드 규칙이 없으면 별다른 에러 없이 연결이 멈춘 것처럼 보일 수 있다는 점도 확인했습니다.
이 외에도 FSx 생성 단계에서는 fsxadmin과 vsadmin 암호를 각각 설정해야 한다는 점을 놓치기 쉬웠습니다. 두 계정 모두 8자 이상의 암호가 필요하며, 하나라도 누락되면 생성 단계에서 Validation 에러가 발생합니다. 단순한 설정 항목처럼 보이지만, 실제로는 생성 자체가 실패하는 원인이 될 수 있으므로 미리 확인하는 것이 좋습니다.
Amazon FSx for NetApp ONTAP은 AWS에서 관리형으로 제공되는 서비스인 만큼 기본적인 구성은 어렵지 않지만, ONTAP 특유의 개념과 CLI 명령어, 그리고 네트워크 및 보안 그룹 설정까지 함께 이해해야 원활하게 사용할 수 있습니다. 특히 FlexCache와 같은 기능을 처음 구성하는 경우에는 작은 설정 하나가 예상치 못한 오류로 이어질 수 있으므로, 이번 글에서 소개한 내용이 비슷한 문제를 겪는 분들에게 도움이 되었으면 합니다.
