Linux용 iSCSI 프로비저닝

iSCSI 클라이언트 설치

1. Linux 디바이스에 iscsi-initiator-utils 및 device-mapper-multipath가 설치되어 있는지 확인합니다. SSH 클라이언트를 사용하여 Linux 인스턴스에 연결합니다. 자세한 내용은 SSH를 사용하여 Linux 인스턴스에 연결을 참조하세요.

2. 다음 명령을 사용하여 multipath와 iSCSI 클라이언트를 설치하세요. 파일 서버 간에 자동으로 장애 조치하려면 multipath를 설치해야 합니다.

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

3. 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

4. iSCSI 서비스를 시작합니다.

   ~$ sudo service iscsid start

   단, Linux 버전에 따라 다음 명령을 대신 사용해야 할 수도 있습니다.

   ~$ sudo systemctl start iscsid

5. 다음 명령을 사용하여 에이전트가 실행 중인지 확인합니다.

   ~$ 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

2. 다음 명령을 사용하여 Linux 호스트의 이니시에이터 이름을 확인합니다. 이니시에이터 이름의 위치는 iSCSI 유틸리티에 따라 다릅니다. iscsi-initiator-utils를 사용하는 경우 이니시에이터 이름은 /etc/iscsi/initiatorname.iscsi 파일에 있습니다.

   ~$ sudo cat /etc/iscsi/initiatorname.iscsi

   시스템이 이니시에이터 이름으로 응답합니다.

   InitiatorName=iqn.1994-05.com.redhat:abcdef12345

1. 다음 명령을 사용하여 iSCSI LUN을 생성한 FSx for ONTAP 파일 시스템의 NetApp ONTAP CLI에 연결합니다. 자세한 내용은 NetApp ONTAP CLI 사용 섹션을 참조하세요.

   ~$ ssh fsxadmin@your_management_endpoint_ip

2. NetApp ONTAP CLI lun igroup create 명령을 사용하여 이니시에이터 그룹(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 생성을 참조하세요.

3. lun igroup show 명령을 사용하여 igroup이 존재하는지 확인합니다.

   ::> lun igroup show

   시스템이 다음 출력으로 응답합니다.

   Vserver   Igroup       Protocol OS Type  Initiators
   --------- ------------ -------- -------- ------------------------------------
   svm_name  igroup_name  iscsi    linux    iqn.1994-05.com.redhat:abcdef12345

4. 이 단계에서는 이미 iSCSI LUN을 생성한 것으로 가정합니다. 아직 생성되지 않은 경우 단계별 지침으로 iSCSI LUN 생성 섹션을 참조하여 생성합니다.

   lun mapping create 명령을 사용해서 다음 속성을 지정하여 생성된 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

5. lun show -path 명령을 사용하여 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)을 저장하면, 이후 단계에서 이 값을 사용하여 블록 장치에 친숙한 이름을 만들 수 있습니다.

6. network interface show -vserver 명령을 사용하여 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입니다.

대상 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에 해당합니다.

2. (선택 사항) Amazon EC2 단일 클라이언트 최대 처리량인 5Gb/s(~625MB/s)보다 더 높은 처리량을 iSCSI LUN으로 전송하려면 Linux 인스턴스용 Amazon Elastic Compute Cloud 사용자 가이드의 Amazon EC2 인스턴스 네트워크 대역폭에 설명된 절차에 따라 처리량 향상을 위한 추가 세션을 설정하세요.

   다음 명령은 각 가용 영역에서 ONTAP 노드당 이니시에이터별로 8개의 세션을 설정하여 클라이언트가 iSCSI LUN에 최대 40Gb/s(5,000MB/s)의 총 처리량을 제공할 수 있도록 합니다.

   ~$ sudo iscsiadm --mode node -T target_initiator --op update -n node.session.nr_sessions -v 8

3. 대상 이니시에이터에 로그인합니다. 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개입니다.

4. 다음 명령을 사용하여 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 구성 절차에서 저장한 값으로 바꿉니다.

   • 예제에 표시된 대로 serial_hex 값에 접두사 3600a0980을 추가합니다. 이것은Amazon FSx for NetApp ONTAP이 사용하는 NetApp ONTAP 배포판의 고유한 프리앰블입니다.

   • device_name을 디바이스에 사용할 친숙한 이름으로 바꿉니다.

   multipaths {
       multipath {
           wwid 3600a0980serial_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

2. multipathd 서비스를 다시 시작하여 /etc/multipathd.conf의 변경 사항을 적용합니다.

   ~$ systemctl restart multipathd.service

LUN 파티션

다음 단계는 fdisk를 사용하여 LUN을 포맷하고 파티셔닝하는 것입니다.

1. 다음 명령을 사용하여 device_name에 대한 경로가 있는지 확인합니다.

   ~$ ls /dev/mapper/device_name

   /dev/device_name

2. 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의 형식은 <device_name><partition_number>입니다. 1은 이전 단계의 fdisk 명령에 사용된 파티션 번호로 사용되었습니다.

3. /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

2. 다음 명령을 사용하여 파일 시스템을 마운트합니다.

   ~$ sudo mount -t ext4 /dev/mapper/partition_name /directory_path/mount_point

3. (선택 사항) 특정 사용자에게 탑재 디렉터리의 소유권을 부여하려면 username를 소유자의 사용자 아이디로 바꿉니다.

   ~$ sudo chown username:username /directory_path/mount_point

4. (선택 사항) 파일 시스템에서 데이터를 읽고 쓸 수 있는지 확인합니다.

   ~$ echo "Hello world!" > /directory_path/mount_point/HelloWorld.txt
   ~$ cat directory_path/HelloWorld.txt
   Hello world!

   Linux 클라이언트에 iSCSI LUN을 성공적으로 생성하고 마운트했습니다.