iSCSI를 사용하여 FSx for ONTAP iSCSI LUN을 EC2 Linux 인스턴스에 마운트하려면 어떻게 해야 합니까?

해결 방법

참고: 다음 해결 방법은 Amazon Linux 2023(AL2023), Amazon Linux 2(AL2), Red Hat Enterprise Linux(RHEL) 8 및 CentOS 8을 실행하는 Amazon EC2 인스턴스에 대한 것입니다.

사전 요구 사항:

• EC2 인스턴스는 TCP 포트 3260에서 아웃바운드 트래픽을 허용합니다.
• NetApp ONTAP 파일 시스템은 TCP 포트 3260에서 인바운드 트래픽을 허용합니다.
• 필요한 iSCSI 파일 시스템 및 인스턴스를 구성합니다.
  참고: AL2 인스턴스에 대한 요구 사항은 AL2023 인스턴스에 대한 요구 사항과 동일합니다.

iSCSI를 사용하여 인스턴스에 파일 시스템 마운트

다음 단계를 완료합니다.

1. 필수 패키지를 설치하려면 다음 명령을 실행합니다.

   sudo yum install -y iscsi-initiator-utils device-mapper-multipath

2. 파일 시스템의 다중 경로를 구성하려면 다음 명령을 실행합니다.

   sudo mpathconf --enable --with_multipathd y
   sudo systemctl start multipathd
   sudo systemctl enable multipathd

3. 스토리지 가상 머신(SVM)의 블록 스토리지 인터페이스 주소를 검색하려면 ONTAP 명령줄 인터페이스(CLI)를 사용합니다. FSx ONTAP 파일 시스템에서 다음 명령을 실행합니다.

   network interface show -vserver svm_name

   참고: svm_name을 SVM 이름으로 바꾸십시오.
   출력 예시:

               Logical               Status         Network            Current                    Current Is
   Vserver     Interface             Admin/Oper     Address/Mask       Node                       Port    Home
   ----------- ----------            ----------     ------------------ -------------              ------- ----
   svm_name
               iscsi_1               up/up          iscsi_1_IP/X       FSxId0123456789abcdef8-01  e0e     true
               iscsi_2               up/up          iscsi_2_IP/X       FSxId0123456789abcdef8-02  e0e     true
   2 entries were displayed.

4. iSCSI 대상을 검색하려면 EC2 인스턴스에서 다음 명령을 실행하여 대상 이니시에이터를 찾으십시오.

   sudo iscsiadm --mode discovery --op update --type sendtargets --portal iscsi_1_IP

   참고: iscsi_1_IP를 이전 명령에서 받은 iscsi_1 IP 주소로 바꾸십시오.
   출력 예시:

   iscsi_1:3260,1029 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3
   iscsi_2:3260,1028 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3

   위의 예제 출력에서 대상 이니시에이터는 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3입니다.

5. (선택 사항) 각 가용 영역의 각 ONTAP 노드에 있는 각 이니시에이터에서 8개 세션을 설정하려면 다음 명령을 실행합니다.

   sudo iscsiadm --mode node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 --op update -n node.session.nr_sessions -v 8

   참고: iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3을 대상 이니시에이터로 바꾸십시오.

6. iSCSI 대상에 로그인하려면 다음 명령을 실행합니다.

   sudo iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -l

   참고: iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3을 대상 이니시에이터로 바꾸십시오.

7. 다중 경로 디바이스를 찾으려면 다음 명령을 실행합니다.

   sudo multipath -ll

   출력 예시:

   3600a09806c5742314e5d52766e79614f dm-xyz NETAPP ,LUN C-Mode
   size=10G features='4 queue_if_no_path pg_init_retries 50 retain_attached_hw_handle' hwhandler='0' wp=rw
   |-+- policy='service-time 0' prio=50 status=active |
   |- 0:0:0:1 sda 8:0 active ready running |
   |- 1:0:0:1 sdc 8:32 active ready running |
   |- 3:0:0:1 sdg 8:96 active ready running | `
   - 4:0:0:1 sdh 8:112 active ready running `
   -+- policy='service-time 0' prio=10 status=enabled
   |- 2:0:0:1 sdb 8:16 active ready running
   |- 7:0:0:1 sdf 8:80 active ready running
   |- 6:0:0:1 sde 8:64 active ready running
   `- 5:0:0:1 sdd 8:48 active ready running

   위의 예제 출력에서 심볼 링크는 3600a09806c5742314e5d52766e79614f입니다. 심볼릭 링크는 /dev/mapper/wwid 경로에서 찾을 수 있습니다. 여기서 wwid는 LUN의 디바이스 간 고유 식별자입니다.

8. 파일 시스템을 생성하려면 다음 명령을 실행합니다.

   sudo mkfs.xfs /dev/mapper/wwid

   참고: wwid를 LUN의 고유 식별자로 바꾸십시오.

9. 마운트 지점을 생성하여 마운트하려면 다음 명령을 실행합니다.

   sudo mkdir /mnt/fsx-iscsi
   sudo mount /dev/mapper/wwid /mnt/fsx-iscsi

10. (선택 사항) 부팅 시 자동 마운트를 구성하려면 다음 명령을 실행하여 iSCSI 서비스를 활성화합니다.

sudo systemctl enable iscsid
sudo systemctl enable iscsi

그런 다음 /etc/fstab 파일에 다음 줄을 추가합니다.

/dev/mapper/wwid /mnt/fsx-iscsi xfs _netdev,x-systemd.automount,x-systemd.requires=network-online.target 0 0

참고: wwid를 LUN의 고유 식별자로 바꾸고 /mnt/fsx-iscsi를 파일 경로로 바꾸십시오. /etc/systemd/system/ 파일 경로를 사용하여 iSCSI 로그인을 위한 systemd 서비스 파일을 생성합니다.
예시 파일은 다음과 같습니다.

[Unit]
Description=iSCSI connection to FSx
After=network.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -l
ExecStop=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -u

[Install]
WantedBy=multi-user.target

참고: iscsi_1_IP를 사용 중인 iscsi_1 IP 주소로 바꾸고 region을 사용 중인 AWS 리전으로 바꾸십시오. 서비스를 활성화하고 시작하려면 다음 명령을 실행합니다.

sudo systemctl enable iscsi-fsx.service
sudo systemctl start iscsi-fsx.service
sudo systemctl status iscsi-fsx.service

ISCSI 마운트 문제 해결

중요: NetApp 계정을 생성하는 것이 모범 사례입니다. NetApp 지식 베이스에 액세스하려면 NetApp 계정이 있어야 합니다.

EC2 Linux 서버 문제 해결

파일 시스템을 마운트할 때 문제가 발생하면 다음과 같은 문제 해결 조치를 취하십시오.

• 필요한 포트에서 연결을 확인하려면 다음 명령을 실행합니다.

  telnet iscsi_1_IP 3260

  참고: iscsi_1_IP를 사용 중인 iscsi_1 IP 주소로 바꾸십시오.

• iSCSI 검색이 예상대로 작동하는지 확인하려면 다음 명령을 실행합니다.

  sudo iscsiadm -m discovery --op update -t sendtargets -p iscsi_1_IP

  참고: iscsi_1_IP를 사용 중인 iscsi_1 IP 주소로 바꾸십시오.

• 활성 iSCSI 세션의 상태를 확인하고 문제를 식별하려면 다음 명령을 실행합니다.

  sudo iscsiadm -m session

• 다중 경로가 예상대로 작동하는지 확인하려면 다음 명령을 실행합니다.

  sudo multipath -ll

• 로그에서 오류를 확인하려면 다음 명령 중 하나를 실행합니다.

  dmesg | grep iSCSI

  -또는-

  journalctl -u iscsid

마운트 문제를 추가로 해결하려면 NetApp 웹 사이트에서 호스트에 표시되지 않는 iSCSI LUN 문제 해결을 참조하십시오.

FSx for ONTAP 서버 문제 해결

iSCSI 서비스가 실행되고 있는지 확인하려면 다음 명령을 실행합니다.

vserver iscsi show
iscsi session show

LUN 구성에 문제가 있는지 확인하려면 다음 명령을 실행합니다.

lun show -vserver vserver_name

참고: vserver_name을 서버 이름으로 바꾸십시오.

스토리지 액세스를 올바르게 구성했는지 확인하려면 다음 명령을 실행하여 LUN과 이니시에이터 그룹 간의 매핑을 확인합니다.

lun mapping show

igroup 구성을 확인하고 이니시에이터가 포함되어 있는지 확인하려면 다음 명령을 실행합니다.

igroup show -instance