기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Linux용 iSCSI 프로비저닝 FSx for ONTAP는 iSCSI 프로토콜을 지원합니다. iSCSI 프로토콜을 사용하여 클라이언트와 파일 시스템 간에 데이터를 전송하려면 Linux 클라이언트와 파일 시스템 모두에서 iSCSI를 프로비저닝해야 합니다. iSCSI 프로토콜은 [고가용성 페어(HA)](HA-pairs.md)가 6개 이하인 모든 파일 시스템에서 사용할 수 있습니다. Amazon FSx for NetApp ONTAP에서 iSCSI를 구성하는 세 가지 주요 단계는 다음 절차에서 다룹니다. 1. Linux 호스트에 iSCSI 클라이언트를 설치하고 구성합니다. 1. 파일 시스템의 SVM에서 iSCSI를 구성합니다. + iSCSI 이니시에이터 그룹을 생성합니다. + 이니시에이터 그룹을 LUN에 매핑합니다. 1. Linux 클라이언트에 iSCSI LUN 마운트 ## 시작하기 전 준비 사항 iSCSI용 파일 시스템을 구성하는 프로세스를 시작하기 전에 다음 항목을 완료해야 합니다. + FSx for ONTAP 파일 시스템을 생성합니다. 자세한 내용은 [파일 시스템 만들기](creating-file-systems.md) 단원을 참조하십시오. + 파일 시스템에서 iSCSI LUN을 생성합니다. 자세한 내용은 [iSCSI LUN 생성](create-iscsi-lun.md) 단원을 참조하십시오. + 파일 시스템과 동일한 VPC에서 Amazon Linux 2 AMI(Amazon 머신 이미지)를 실행하는 EC2 인스턴스를 생성합니다. iSCSI를 구성하고 파일 데이터에 액세스할 Linux 호스트입니다. 이러한 절차의 범위를 넘어 호스트가 다른 VPC에 있는 경우 VPC 피어링 또는 AWS Transit Gateway 를 사용하여 다른 VPCs에 볼륨의 iSCSI 엔드포인트에 대한 액세스 권한을 부여할 수 있습니다. 자세한 내용은 [배포 VPC 외부에서 데이터 액세스](supported-fsx-clients.md#access-from-outside-deployment-vpc) 단원을 참조하십시오. + [Amazon VPC를 사용한 파일 시스템 액세스 제어](limit-access-security-groups.md)에 설명된 대로 인바운드 및 아웃바운드 트래픽을 허용하도록 Linux 호스트의 VPC 보안 그룹을 구성합니다. + ONTAP CLI에 액세스하는 데 사용할 `fsxadmin` 권한이 있는 ONTAP 사용자의 자격 증명을 가져옵니다. 자세한 내용은 [ONTAP 사용자 및 역할](roles-and-users.md) 단원을 참조하십시오. + iSCSI용으로 구성하고 FSx for ONTAP 파일 시스템에 액세스하는 데 사용할 Linux 호스트는 동일한 VPC와 AWS 계정에 있습니다. + 다음 그림과 같이 EC2 인스턴스는 파일 시스템의 기본 서브넷과 동일한 가용 영역에 배치하는 것이 좋습니다. ![Amazon FSx for NetApp ONTAP 파일 시스템에서 iSCSI LUN과 Amazon EC2 인스턴스가 파일 시스템의 기본 서브넷과 동일한 가용성 영역에 위치하고 있음을 보여주는 이미지입니다.](http://docs.aws.amazon.com/ko_kr/fsx/latest/ONTAPGuide/images/fsx-ontap-iscsi-mnt-client.png) EC2 인스턴스가 Amazon Linux 2과 다른 Linux AMI를 실행하는 경우 이러한 절차 및 예제에 사용된 일부 유틸리티가 이미 설치되어 있을 수 있으며, 다른 명령을 사용하여 필요한 패키지를 설치할 수 있습니다. 패키지 설치 외에도 이 섹션에 사용된 명령은 다른 EC2 Linux AMI에도 유효합니다. **Topics** + [시작하기 전 준비 사항](#iscsi-linux-byb) + [Linux 호스트에 iSCSI 설치 및 구성](#configure-iscsi-on-linux-client) + [FSx for ONTAP 파일 시스템에 iSCSI 구성](#configure-iscsi-on-fsx-ontap) + [Linux 클라이언트에 iSCSI LUN 마운트](#mount-iscsi-lun-on-linux-client) ## Linux 호스트에 iSCSI 설치 및 구성 **iSCSI 클라이언트 설치** 1. Linux 디바이스에 `iscsi-initiator-utils` 및 `device-mapper-multipath`가 설치되어 있는지 확인합니다. SSH 클라이언트를 사용하여 Linux 인스턴스에 연결합니다. 자세한 내용은 [SSH를 사용하여 Linux 인스턴스에 연결](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html)을 참조하세요. 1. 다음 명령을 사용하여 `multipath`와 iSCSI 클라이언트를 설치하세요. 파일 서버 간에 자동으로 장애 조치하려면 `multipath`를 설치해야 합니다. ``` ~$ sudo yum install -y device-mapper-multipath iscsi-initiator-utils ``` 1. `multipath`를 사용하는 경우 파일 서버 간에 자동으로 장애 조치할 때 응답 속도를 높이려면 `/etc/iscsi/iscsid.conf` 파일의 대체 제한 시간 값을 기본값인 `120` 대신 `5`로 설정합니다. ``` ~$ sudo sed -i 's/node.session.timeo.replacement_timeout = .*/node.session.timeo.replacement_timeout = 5/' /etc/iscsi/iscsid.conf; sudo cat /etc/iscsi/iscsid.conf | grep node.session.timeo.replacement_timeout ``` 1. iSCSI 서비스를 시작합니다. ``` ~$ sudo service iscsid start ``` 단, Linux 버전에 따라 다음 명령을 대신 사용해야 할 수도 있습니다. ``` ~$ sudo systemctl start iscsid ``` 1. 다음 명령을 사용하여 에이전트가 실행 중인지 확인합니다. ``` ~$ sudo systemctl status iscsid.service ``` 시스템이 다음 출력으로 응답합니다. ``` iscsid.service - Open-iSCSI Loaded: loaded (/usr/lib/systemd/system/iscsid.service; disabled; vendor preset: disabled) Active: active (running) since Fri 2021-09-02 00:00:00 UTC; 1min ago Docs: man:iscsid(8) man:iscsiadm(8) Process: 14658 ExecStart=/usr/sbin/iscsid (code=exited, status=0/SUCCESS) Main PID: 14660 (iscsid) CGroup: /system.slice/iscsid.service ├─14659 /usr/sbin/iscsid └─14660 /usr/sbin/iscsid ``` **Linux 클라이언트에 iSCSI 구성** 1. 클라이언트가 파일 서버 간에 자동으로 장애 조치할 수 있도록 하려면 다중 경로를 구성해야 합니다. 다음 명령을 사용합니다. ``` ~$ sudo mpathconf --enable --with_multipathd y ``` 1. 다음 명령을 사용하여 Linux 호스트의 이니시에이터 이름을 확인합니다. 이니시에이터 이름의 위치는 iSCSI 유틸리티에 따라 다릅니다. `iscsi-initiator-utils`를 사용하는 경우 이니시에이터 이름은 `/etc/iscsi/initiatorname.iscsi` 파일에 있습니다. ``` ~$ sudo cat /etc/iscsi/initiatorname.iscsi ``` 시스템이 이니시에이터 이름으로 응답합니다. ``` InitiatorName=iqn.1994-05.com.redhat:abcdef12345 ``` ## FSx for ONTAP 파일 시스템에 iSCSI 구성 1. 다음 명령을 사용하여 iSCSI LUN을 생성한 FSx for ONTAP 파일 시스템의 NetApp ONTAP CLI에 연결합니다. 자세한 내용은 [NetApp ONTAP CLI 사용](managing-resources-ontap-apps.md#netapp-ontap-cli) 섹션을 참조하세요. ``` ~$ ssh fsxadmin@{{your_management_endpoint_ip}} ``` 1. NetApp ONTAP CLI [**lun igroup create**](https://docs.netapp.com/us-en/ontap-cli-9111/lun-igroup-create.html) 명령을 사용하여 이니시에이터 그룹(`igroup`)을 생성합니다. 이니시에이터 그룹은 iSCSI LUN에 매핑되며 LUN에 액세스할 수 있는 이니시에이터(클라이언트)를 제어합니다. `host_initiator_name`을 이전 절차에서 검색한 Linux 호스트의 이니시에이터 이름으로 바꿉니다. ``` ::> lun igroup create -vserver {{{{svm_name}}}} -igroup {{igroup_name}} -initiator {{host_initiator_name}} -protocol iscsi -ostype linux ``` 이 igroup에 매핑된 LUN을 여러 호스트에서 사용할 수 있도록 하려면 여러 이니시에이터 이름을 쉼표로 구분하여 지정할 수 있습니다. 자세한 내용은 *NetApp ONTAP 설명서 센터*의 [lun igroup 생성](https://docs.netapp.com/us-en/ontap-cli-9111/lun-igroup-create.html)을 참조하세요. 1. [**lun igroup show**](https://docs.netapp.com/us-en/ontap-cli-9111/lun-igroup-show.html) 명령을 사용하여 `igroup`이 존재하는지 확인합니다. ``` ::> lun igroup show ``` 시스템이 다음 출력으로 응답합니다. ``` Vserver Igroup Protocol OS Type Initiators --------- ------------ -------- -------- ------------------------------------ {{svm_name}} {{igroup_name}} iscsi linux iqn.1994-05.com.redhat:abcdef12345 ``` 1. 이 단계에서는 이미 iSCSI LUN을 생성한 것으로 가정합니다. 아직 생성되지 않은 경우 단계별 지침으로 [iSCSI LUN 생성](create-iscsi-lun.md) 섹션을 참조하여 생성합니다. [**lun mapping create**](https://docs.netapp.com/us-en/ontap-cli-9111/lun-mapping-create.html) 명령을 사용해서 다음 속성을 지정하여 생성된 LUN과 생성된 igroup 사이의 매핑을 생성합니다. + `{{svm_name}}` – iSCSI 대상을 제공하는 스토리지 가상 머신의 이름입니다. 호스트는 이 값을 사용하여 LUN에 도달합니다. + `{{vol_name}}` – LUN을 호스팅하는 볼륨의 이름입니다. + `{{lun_name}}` – LUN에 할당한 이름입니다. + `{{igroup_name}}` – 이니시에이터 그룹의 이름입니다. + `{{lun_id}}` – LUN ID 정수는 LUN 자체가 아니라 매핑에만 해당됩니다. 이는 igroup의 이니시에이터에 의해 사용되며, 이니시에이터가 스토리지에 액세스할 때 논리 유닛 번호로 사용됩니다. ``` ::> lun mapping create -vserver {{svm_name}} -path /vol/{{vol_name}}/{{lun_name}} -igroup {{igroup_name}} -lun-id {{lun_id}} ``` 1. [`lun show -path`](https://docs.netapp.com/us-en/ontap-cli-9111/lun-show.html) 명령을 사용하여 LUN이 생성되고 온라인 상태이며 매핑되었는지 확인합니다. ``` ::> lun show -path /vol/{{vol_name}}/{{lun_name}} -fields state,mapped,serial-hex ``` 시스템이 다음 출력으로 응답합니다. ``` Vserver Path serial-hex state mapped --------- ------------------------------- ------------------------ -------- -------- {{svm_name}} /vol/{{vol_name}}/{{lun_name}} 6c5742314e5d52766e796150 online mapped ``` `serial_hex` 값(이 예제에서는 `6c5742314e5d52766e796150`)을 저장하면, 이후 단계에서 이 값을 사용하여 블록 장치에 친숙한 이름을 만들 수 있습니다. 1. [`network interface show -vserver`](https://docs.netapp.com/us-en/ontap-cli-9111/network-interface-show.html) 명령을 사용하여 iSCSI LUN을 생성한 SVM의 `iscsi_1` 및 `iscsi_2` 인터페이스 주소를 검색합니다. ``` ::> network interface show -vserver {{{{svm_name}}}} ``` 시스템이 다음 출력으로 응답합니다. ``` Logical Status Network Current Current Is Vserver Interface Admin/Oper Address/Mask Node Port Home ----------- ---------- ---------- ------------------ ------------- ------- ---- {{svm_name}} iscsi_1 up/up 172.31.0.143/20 FSxId0123456789abcdef8-01 e0e true iscsi_2 up/up 172.31.21.81/20 FSxId0123456789abcdef8-02 e0e true nfs_smb_management_1 up/up 198.19.250.177/20 FSxId0123456789abcdef8-01 e0e true 3 entries were displayed. ``` 이 예제에서 `iscsi_1`의 IP 주소는 `172.31.0.143`이고 `iscsi_2`의 IP 주소는 `172.31.21.81`입니다. ## Linux 클라이언트에 iSCSI LUN 마운트 Linux 클라이언트에 iSCSI LUN을 탑재하는 프로세스는 세 단계로 구성됩니다. 1. 대상 iSCSI 노드 검색 1. iSCSI LUN 분할 1. 클라이언트에 iSCSI LUN 탑재 이는 다음 절차에서 다룹니다. **대상 iSCSI 노드를 검색하려면** 1. Linux 클라이언트에서 `iscsi_1`의 IP 주소인 {{iscsi\_1\_IP}}를 사용하여 대상 iSCSI 노드를 검색하려면 다음 명령을 사용합니다. ``` ~$ sudo iscsiadm --mode discovery --op update --type sendtargets --portal {{iscsi_1_IP}} ``` ``` 172.31.0.143:3260,1029 iqn.1992-08.com.netapp:sn.9cfa2c41207a11ecac390182c38bc256:vs.3 172.31.21.81:3260,1028 iqn.1992-08.com.netapp:sn.9cfa2c41207a11ecac390182c38bc256:vs.3 ``` 이 예제에서 `iqn.1992-08.com.netapp:sn.9cfa2c41207a11ecac390182c38bc256:vs.3`은 기본 가용성 영역에 있는 iSCSI LUN의 `target_initiator`에 해당합니다. 1. (선택 사항) Amazon EC2 단일 클라이언트 최대 처리량인 5Gbps(\~625MBps)보다 더 높은 처리량을 iSCSI LUN으로 전송하려면 Linux 인스턴스용 Amazon Elastic Compute Cloud 사용 설명서의 [Amazon EC2 인스턴스 네트워크 대역폭](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-network-bandwidth.html)에 설명된 절차에 따라 처리량 향상을 위한 추가 세션을 설정하세요. 다음 명령은 각 가용 영역에서 ONTAP 노드당 이니시에이터별로 8개의 세션을 설정하여 클라이언트가 iSCSI LUN에 최대 40Gbps(5,000MBps)의 총 처리량을 제공할 수 있도록 합니다. ``` ~$ sudo iscsiadm --mode node -T {{target_initiator}} --op update -n node.session.nr_sessions -v 8 ``` 1. 대상 이니시에이터에 로그인합니다. iSCSI LUN이 사용 가능한 디스크로 표시됩니다. ``` ~$ sudo iscsiadm --mode node -T {{target_initiator}} --login ``` ``` Logging in to [iface: default, target: iqn.1992-08.com.netapp:sn.9cfa2c41207a11ecac390182c38bc256:vs.3, portal: 172.31.14.66,3260] (multiple) Login to [iface: default, target: iqn.1992-08.com.netapp:sn.9cfa2c41207a11ecac390182c38bc256:vs.3, portal: 172.31.14.66,3260] successful. ``` 위 출력은 잘렸습니다. 각 파일 서버의 세션마다 `Logging in` 응답과 `Login successful` 응답이 하나씩 표시되어야 합니다. 노드당 세션이 4개인 경우 응답은 `Logging in` 8개와 `Login successful` 8개입니다. 1. 다음 명령을 사용하여 `dm-multipath`가 여러 정책이 있는 단일 LUN을 표시하여 iSCSI 세션을 식별하고 병합했는지 확인합니다. `active`로 나열된 디바이스와 `enabled`로 나열된 디바이스 수가 같아야 합니다. ``` ~$ sudo multipath -ll ``` 출력에서 디스크 이름은 `dm-xyz`와 같은 형식으로 지정됩니다. 여기서 `xyz`는 정수입니다. 다른 멀티패스 디스크가 없는 경우 이 값은 `dm-0`입니다. ``` 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 ``` 이제 블록 디바이스가 Linux 클라이언트에 연결되었습니다. 이는 `/dev/{{dm-xyz}}` 경로에 있습니다. 이 경로를 관리 목적으로 사용해서는 안 됩니다. 대신 경로 `/dev/mapper/{{wwid}}`에 있는 심볼 링크를 사용합니다. 여기서 `{{wwid}}`는 디바이스 간에 일관된 LUN의 고유 식별자입니다. 다음 단계에서는 다른 다중 경로 디스크와 구별할 수 있도록 `{{wwid}}`에 친숙한 이름을 지정합니다. **블록 디바이스에 표시 이름을 할당하려면** 1. `/etc/multipath.conf` 파일에 별칭을 만들어 디바이스에 친숙한 이름을 지정합니다. 이렇게 하려면 선호하는 텍스트 편집기를 사용하여 다음 자리 표시자를 대체하여 파일에 다음 항목을 추가합니다. + `serial_hex`를 [FSx for ONTAP 파일 시스템에 iSCSI 구성](#configure-iscsi-on-fsx-ontap) 절차에서 저장한 값으로 바꿉니다. + 예제에 표시된 대로 `serial_hex` 값에 접두사 `3600a0980`을 추가합니다. 이것은Amazon FSx for NetApp ONTAP이 사용하는 NetApp ONTAP 배포판의 고유한 프리앰블입니다. + `device_name`을 디바이스에 사용할 친숙한 이름으로 바꿉니다. ``` multipaths { multipath { wwid 3600a0980{{serial_hex}} alias {{device_name}} } } ``` 또는 다음 스크립트를 bash 파일(예: `multipath_alias.sh`)로 복사하여 저장할 수도 있습니다. `{{serial_hex}}`(3600a0980 접두사 없이) 및 `{{device_name}}`을 해당 일련 번호 및 원하는 친숙한 이름으로 바꾸어 sudo 권한을 사용하여 스크립트를 실행할 수 있습니다. 이 스크립트는 `/etc/multipath.conf` 파일에서 주석이 없는 `multipaths` 섹션을 검색합니다. 해당 항목이 있으면 해당 섹션에 `multipath` 항목이 추가됩니다. 없으면 블록 디바이스에 `multipath` 항목이 있는 새 `multipaths` 섹션이 생성됩니다. ``` #!/bin/bash SN=serial_hex ALIAS=device_name CONF=/etc/multipath.conf grep -q '^multipaths {' $CONF UNCOMMENTED=$? if [ $UNCOMMENTED -eq 0 ] then sed -i '/^multipaths {/a\\tmultipath {\n\t\twwid 3600a0980'"${SN}"'\n\t\talias '"${ALIAS}"'\n\t}\n' $CONF else printf "multipaths {\n\tmultipath {\n\t\twwid 3600a0980$SN\n\t\talias $ALIAS\n\t}\n}" >> $CONF fi ``` 1. `multipathd` 서비스를 다시 시작하여 `/etc/multipathd.conf`의 변경 사항을 적용합니다. ``` ~$ systemctl restart multipathd.service ``` **LUN 파티션** 다음 단계는 `fdisk`를 사용하여 LUN을 포맷하고 파티셔닝하는 것입니다. 1. 다음 명령을 사용하여 `device_name`에 대한 경로가 있는지 확인합니다. ``` ~$ ls /dev/mapper/{{device_name}} ``` ``` /dev/{{device_name}} ``` 1. `fdisk`를 사용하여 디스크를 파티셔닝합니다. 대화형 프롬프트가 나타날 것입니다. 표시된 순서대로 옵션을 입력합니다. 마지막 섹터보다 작은 값(이 예제에서는 `20971519`)을 사용하여 여러 파티션을 만들 수 있습니다. **참고** `Last sector` 값은 iSCSI LUN의 크기(이 예에서는 10GB)에 따라 달라집니다. ``` ~$ sudo fdisk /dev/mapper/{{device_name}} ``` `fsdisk` 대화형 프롬프트가 시작됩니다. ``` Welcome to fdisk (util-linux 2.30.2). Changes will remain in memory only, until you decide to write them. Be careful before using the write command. Device does not contain a recognized partition table. Created a new DOS disklabel with disk identifier 0x66595cb0. Command (m for help): n Partition type p primary (0 primary, 0 extended, 4 free) e extended (container for logical partitions) Select (default p): p Partition number (1-4, default 1): 1 First sector (2048-20971519, default 2048): 2048 Last sector, +sectors or +size{K,M,G,T,P} (2048-20971519, default 20971519): 20971519 Created a new partition 1 of type 'Linux' and of size 512 B. Command (m for help): w The partition table has been altered. Calling ioctl() to re-read partition table. Syncing disks. ``` `w`를 입력하면 새 파티션 `/dev/mapper/{{partition_name}}`을 사용할 수 있게 됩니다. {{partition\_name}}의 형식은 {{}}{{}}입니다. `1`은 이전 단계의 `fdisk` 명령에 사용된 파티션 번호로 사용되었습니다. 1. `/dev/mapper/{{partition_name}}`을 경로로 사용하여 파일 시스템을 생성합니다. ``` ~$ sudo mkfs.ext4 /dev/mapper/{{partition_name}} ``` 시스템이 다음 출력으로 응답합니다. ``` mke2fs 1.42.9 (28-Dec-2013) Discarding device blocks: done Filesystem label= OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) Stride=0 blocks, Stripe width=16 blocks 655360 inodes, 2621184 blocks 131059 blocks (5.00%) reserved for the super user First data block=0 Maximum filesystem blocks=2151677952 80 block groups 32768 blocks per group, 32768 fragments per group 8192 inodes per group Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632 Allocating group tables: done Writing inode tables: done Creating journal (32768 blocks): done Writing superblocks and filesystem accounting information: done ``` **Linux 클라이언트에 LUN 마운트** 1. {{directory\_path}} 디렉터리를 파일 시스템의 마운트 지점으로 생성합니다. ``` ~$ sudo mkdir /{{directory_path}}/{{mount_point}} ``` 1. 다음 명령을 사용하여 파일 시스템을 마운트합니다. ``` ~$ sudo mount -t ext4 /dev/mapper/{{partition_name}} /{{directory_path}}/{{mount_point}} ``` 1. (선택 사항) 특정 사용자에게 탑재 디렉터리의 소유권을 부여하려면 {{`username`}}를 소유자의 사용자 아이디로 바꿉니다. ``` ~$ sudo chown {{username}}:{{username}} /{{directory_path}}/{{mount_point}} ``` 1. (선택 사항) 파일 시스템에서 데이터를 읽고 쓸 수 있는지 확인합니다. ``` ~$ echo "Hello world!" > /{{directory_path}}/{{mount_point}}/HelloWorld.txt ~$ cat {{directory_path}}/HelloWorld.txt Hello world! ``` Linux 클라이언트에 iSCSI LUN을 성공적으로 생성하고 마운트했습니다.