시작하기 전에

1. Block Storage for Classic 볼륨에 액세스할 호스트가 인증되었는지 확인하십시오. 자세한 내용은 콘솔에서 호스트 권한 부여, CLI에서 호스트 권한 부여, Terraform을 사용하여 호스트 권한 부여를 참조하세요.

2. IBM Cloud 의 비공개 네트워크에 액세스하고 여러 서비스와 상호 작용하려면 활성 VPN 연결이 필요합니다.

3. 서버에 SSH 연결을 설정합니다. IP 주소, 사용자 아이디, 비밀번호는 콘솔에서 찾을 수 있습니다. 메뉴 인프라 > 클래식 인프라 > 장치를 클릭합니다. 그런 다음 목록에서 서버를 찾아 이름을 클릭하면 세부 정보가 표시됩니다.

여러 호스트가 동일한 Block Storage for Classic 볼륨을 공동으로 관리하지 않고 마운트하면 데이터가 손상될 위험이 있습니다. 여러 호스트가 동시에 볼륨을 변경하면 볼륨 손상이 발생할 수 있습니다. 데이터 손실을 방지하려면 Microsoft 클러스터 공유 볼륨( CSV ), Red Hat 글로벌 파일 시스템( GFS2 ), VMware® VMFS 등과 같은 클러스터 인식 공유 디스크 파일 시스템이 필요합니다. 자세한 내용은 운영 체제 설명서를 참조하십시오.

OS를 업데이트하고 iSCSI 및 다중 경로 유틸리티를 설치합니다

시스템이 최신 상태인지 확인하고, ‘ iscsi-initiator-utils ’ 및 ‘ device-mapper-multipath ’ 패키지가 포함되어 있는지 확인하십시오. 다음 명령을 사용하여 패키지를 설치하십시오.

1. OS를 업데이트합니다.

   sudo dnf update
   

2. 다중 경로 유틸리티 설치

   sudo dnf -y install device-mapper-multipath
   

   패키지가 설치되면 mpathconf --enable --user_friendly_names n 명령을 입력하여 활성화합니다.

3. ISCSI 유틸리티 설치

   sudo dnf -y install iscsi-initiator-utils
   

   패키지가 설치되면 systemctl start iscsid 명령으로 패키지를 시작합니다.

iSCSI 구성 파일 업데이트

1. IBM Cloud® 콘솔에서 확인한 IQN을 사용하여 /etc/iscsi/initiatorname.iscsi 파일을 업데이트하십시오.

   1. 다음 예는 현재 개시자 이름을 확인하는 방법을 보여줍니다.

   [root@vsi4classic ~]# cat /etc/iscsi/initiatorname.iscsi
   InitiatorName=iqn.1994-05.com.redhat:7acdadcdc20
   

   1. 텍스트 편집기에서 파일을 엽니다:

   vi /etc/iscsi/initiatorname.iscsi
   

   1. 다음 예제에서 볼 수 있듯이 다음 형식으로 IQN을 입력합니다 InitiatorName=<value-from-the-Portal>. IQN 값을 자신의 값으로 바꿉니다.

   InitiatorName=iqn.2025-11.com.ibm:sl02su1414935-v154455886
   

   1. 파일을 저장(:w)하고 종료(:x)합니다.

2. IBM Cloud® 콘솔의 사용자 이름과 비밀번호를 사용하여 /etc/iscsi/iscsid.conf 에서 다음 항목의 주석을 해제하고 업데이트합니다. CHAP(챌린지-핸드셰이크 인증 프로토콜) 이름에는 대문자를 사용합니다.

   node.session.auth.authmethod = CHAP
   node.session.auth.username = <Username-value-from-Portal>
   node.session.auth.password = <Password-value-from-Portal>
   discovery.sendtargets.auth.authmethod = CHAP
   discovery.sendtargets.auth.username = <Username-value-from-Portal>
   discovery.sendtargets.auth.password = <Password-value-from-Portal>
   

   다른 CHAP 설정은 변경하지 마십시오. IBM Cloud® 저장소는 단방향 인증만 사용합니다. 상호 CHAP를 사용하지 마십시오.

3. iscsid 서비스를 다시 시작하십시오.

   systemctl restart iscsid
   

4. iSCSI 배열에 대해 검색을 실행하여 구성이 올바른지 확인합니다.

   Block Storage for Classic SendTargets 메서드를 사용하는 동적 대상 검색이 필요합니다. 정적 노드 구성을 사용하지 마십시오. 확장성이 떨어질 뿐만 아니라 스토리지 설정(예: 호스트의 LUN 접근 권한 부여 또는 해제)이 변경될 때 연결 문제가 발생할 수 있습니다. 동적 검색을 사용하면 호스트가 대상 포털의 변경 사항을 자동으로 감지할 수 있습니다.

   iscsiadm -m discovery -t sendtargets -p TARGET IP
   

   IP 주소 정보와 접속 내역이 표시되면 검색이 성공한 것입니다.

   [root@vsi4classic ~]# iscsiadm -m discovery -t sendtargets -p 161.26.99.113
    161.26.99.113:3260,1034 iqn.1992-08.com.netapp:stfdal1006
    161.26.99.110:3260,1030 iqn.1992-08.com.netapp:stfdal1006
   

다중 경로 설정

mpathconf 유틸리티를 사용하여 DM Multipath를 설정하면, /etc/multipath.conf 멀티패스 구성 파일이 생성됩니다. mpathconf 유틸리티에 대한 자세한 내용은 mpathconf(8)매뉴얼 페이지를 참조하십시오.

1. 아직 수행하지 않았다면 --enable 옵션과 함께 mpathconf 명령을 입력합니다.

   mpathconf --enable --user_friendly_names n
   

2. nano, vi 또는 원하는 다른 편집기로 /etc/multipath.conf 파일을 편집합니다.

   sudo vi /etc/multipath.conf
   

3. 다음과 같은 최소 구성을 추가하십시오.

   defaults {
   user_friendly_names no
   find_multipaths on
   max_fds max
   flush_on_last_del yes
   queue_without_daemon no
   dev_loss_tmo infinity
   fast_io_fail_tmo 5
   }
   # All data in the following section must be specific to your system.
   blacklist {
   wwid "SAdaptec*"
   devnode "^hd[a-z]"
   devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
   devnode "^cciss.*"
   }
   devices {
   device {
   vendor "NETAPP"
   product "LUN"
   path_grouping_policy group_by_prio
   features "2 pg_init_retries 50"
   no_path_retry queue
   prio "alua"
   path_checker tur
   failback immediate
   path_selector "round-robin 0"
   hardware_handler "1 alua"
   rr_weight uniform
   rr_min_io 128
   }
   }
   

   구성 파일의 초기 기본값 섹션은 멀티패스 장치의 이름이 /dev/mapper/mpath n 형식이 되도록 시스템을 구성합니다. 여기서 mpath n 은 해당 장치의 WWID(World Wide Identifier)입니다.

4. 설정 파일을 저장하고 편집기를 종료합니다.

5. 다음 명령을 실행하십시오.

   systemctl start multipathd.service
   

   멀티패스 데몬을 시작한 후 멀티패스 구성 파일을 수정해야 하는 경우, 변경 사항을 적용하려면 systemctl reload multipathd.service 명령을 실행해야 합니다.

스토리지 디바이스 검색 및 로그인

iscsiadm 유틸리티는 iSCSI( iSCSI ) 대상의 검색 및 로그인, 그리고 open-iscsi 데이터베이스의 액세스 및 관리를 위해 사용되는 명령줄 도구입니다. 자세한 내용은 iscsiadm(8)매뉴얼 페이지를 참조하십시오. 이 단계에서는 IBM Cloud® 콘솔에서 확보한 대상 IP 주소를 사용하여 디바이스를 검색하십시오.

1. iSCSI 어레이에 대해 검색을 실행하십시오.

   iscsiadm -m discovery -t sendtargets -p TARGET IP
   

   IP 주소 정보와 접속 내역이 표시되면 검색이 성공한 것입니다.

2. iSCSI 어레이에 로그인하십시오.

   iscsiadm -m node --login
   

   [root@vsi4classic ~]# iscsiadm -m node --login
   Login to [iface: default, target: iqn.1992-08.com.netapp:stfdal1006, portal: 161.26.99.110,3260] successful.
   Login to [iface: default, target: iqn.1992-08.com.netapp:stfdal1006, portal: 161.26.99.113,3260] successful.
   

구성 확인

1. iSCSI 세션이 설정되었는지 유효성 검증하십시오.

   iscsiadm -m session -o show
   

2. 다중 경로가 있는지 유효성 검증하십시오.

   multipath -l
   

   이 명령은 경로를 보고합니다. 올바르게 구성되어 있다면, 각 볼륨에는 하나의 그룹이 있으며, 이 그룹의 경로 수는 ‘ iSCSI ’ 세션 수와 동일합니다. 단일 경로로 볼륨을 연결할 수는 있지만, 서비스 중단을 방지하기 위해서는 두 경로 모두에 연결이 설정되어 있어야 합니다.

   [root@vsi4classic ~]# multipath -l
   3600a0980383056716724514550666270 dm-0 NETAPP,LUN C-Mode
   size=20G features='3 queue_if_no_path pg_init_retries 50' hwhandler='1 alua' wp=rw
   |-+- policy='round-robin 0' prio=0 status=active
   | `- 2:0:0:0 sda 8:0  active undef running
   `-+- policy='round-robin 0' prio=0 status=enabled
     `- 3:0:0:0 sdb 8:16 active undef running
   

   MPIO가 올바르게 구성되지 않은 경우 네트워크 가동 중단이 발생하거나 IBM Cloud® 팀이 유지보수를 수행할 때 스토리지 디바이스의 연결이 끊기고 오프라인으로 표시될 수 있습니다. MPIO는 이러한 이벤트 발생 시 추가적인 연결성을 제공하며, 활성 읽기/쓰기 작업이 진행 중인 볼륨과의 세션을 유지합니다.

3. 연결된 디바이스의 파티션 테이블을 나열하십시오.

   fdisk -l | grep /dev/mapper
   

   기본적으로 스토리지 디바이스는 /dev/mapper/<wwid>에 첨부됩니다. WWID는 볼륨이 존재하는 동안 지속됩니다. 이 명령은 다음 예와 비슷한 내용을 보고합니다.

   [root@vsi4classic ~]# fdisk -l | grep /dev/mapper
   Disk /dev/mapper/3600a0980383056716724514550666270: 20 GiB, 21474836480 bytes, 41943040 sectors
   

   이 예에서 3600a0980383056716724514550666270 문자열은 WWID입니다. 애플리케이션은 WWID를 사용해야 합니다. 또한 multipath.conf 에서 "user_friendly_names" 또는 "alias" 키워드를 사용하여 더 읽기 쉬운 이름을 지정할 수도 있습니다. 자세한 내용은 [multipath.conf 매뉴얼 페이지를](https://man.linuxreviews.org/man5/multipath.conf.5.html){: external} 참조하십시오.

   이제 볼륨이 마운트되어 호스트에서 액세스 가능합니다. 그런 다음 파일 시스템을 작성할 수 있습니다.

파일 시스템 작성(선택사항)

다음 단계에 따라 새로 마운트된 볼륨에서 파일 시스템을 작성하십시오. 파일 시스템은 볼륨을 사용하는 대부분의 애플리케이션에서 필요합니다. 2TB 미만인 드라이브의 경우 fdisk를 사용하고 2TB보다 큰 디스크의 경우 parted를 사용하십시오.

dnf install parted

MPIO 구성 확인

MPIO가 올바르게 구성되지 않은 경우 네트워크 가동 중단이 발생하거나 IBM Cloud® 팀이 유지보수를 수행할 때 스토리지 디바이스의 연결이 끊기고 오프라인으로 표시될 수 있습니다. MPIO는 이러한 이벤트 발생 시 추가적인 연결성을 제공하며, 활성 읽기/쓰기 작업이 진행 중인 볼륨과의 세션을 유지합니다.

• 다중 경로에서 디바이스를 선택하는지 확인하려면 현재 구성을 나열하십시오. 올바르게 구성된 경우 각 볼륨에 대해 단일 그룹이 존재하며, iSCSI 세션 수와 동일한 수의 경로가 있습니다.

  multipath -l
  

  root@server:~# multipath -l
  3600a09803830304f3124457a45757067 dm-1 NETAPP,LUN C-Mode
  size=20G features='1 queue_if_no_path' hwhandler='0' wp=rw
  |-+- policy='round-robin 0' prio=-1 status=active
  | `6:0:0:101 sdd 8:48 active ready running
  `-+- policy='round-robin 0' prio=-1 status=enabled
   `- 7:0:0:101 sde 8:64 active ready running
  

  예시에 나오는 “ 3600a09803830304f3124457a45757067 ” 문자열은 해당 볼륨의 고유 WWID입니다. 각 볼륨은 고유한 WWID로 식별되며, 이 WWID는 볼륨이 존재하는 동안 변하지 않습니다.

• 모든 디스크가 있는지 확인하십시오. 올바른 구성에서는 두 개의 디스크가 동일한 식별자로 출력에 표시되고 동일한 크기의 /dev/mapper 목록이 동일한 식별자로 표시될 수 있습니다. /dev/mapper 디바이스는 다중 경로에서 설정하는 디바이스입니다.

  fdisk -l | grep Disk
  

  • 올바른 구성의 예제 출력.

  root@server:~# fdisk -l | grep Disk
  Disk /dev/sda: 500.1 GB, 500107862016 bytes Disk identifier: 0x0009170d
  Disk /dev/sdc: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  Disk /dev/sdb: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  Disk /dev/mapper/3600a09803830304f3124457a45757066: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  

  WWID는 다중 경로가 작성하는 디바이스 이름에 포함됩니다. 애플리케이션에서 WWID를 사용하는 것이 좋습니다.

  • 잘못된 구성 출력의 예입니다. /dev/mapper 디스크가 없습니다.

  root@server:~# fdisk -l | grep Disk
  Disk /dev/sda: 500.1 GB, 500107862016 bytes Disk identifier: 0x0009170d
  Disk /dev/sdc: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  Disk /dev/sdb: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  

• 다중 경로 장치 목록에 로컬 디스크가 포함되어 있지 않은지 확인하려면, 상세 수준 3으로 현재 구성을 표시하십시오. 다음 명령의 출력은 디바이스를 표시하고 블록 목록에 추가된 디바이스도 표시합니다.

  multipath -l -v 3 | grep sd <date and time>
  

• 두 번째 경로가 다운된 상태에서 볼륨을 프로비저닝하고 연결하면 검색 검색이 처음 실행될 때 호스트에 단일 경로가 표시될 수 있습니다. 이 드문 현상이 발생하면 IBM Cloud® 상태 페이지에서 호스트의 스토리지 액세스 기능에 영향을 미치는 이벤트가 진행 중인지 확인하세요. 보고된 이벤트가 없는 경우, 모든 경로가 제대로 탐지되었는지 확인하기 위해 탐색 스캔을 다시 실행하십시오. 이벤트가 진행 중인 경우 단일 경로로 스토리지를 연결할 수 있습니다. 그러나 이벤트가 완료된 후 경로가 다시 스캔되어야 합니다. 재검색 후에도 두 경로 모두 발견되지 않으면, 해당 문제를 제대로 조사할 수 있도록 지원 요청을 제출해 주십시오.

Block Storage for Classic 볼륨 마운트 해제

1. 파일 시스템을 마운트 해제하십시오.

   umount /dev/mapper/XXXp1 /PerfDisk
   

2. 해당되는 대상 포털에 기타 볼륨이 없으면 대상에서 로그아웃할 수 있습니다.

   iscsiadm -m node -T <TARGET NAME> -p <PORTAL IP:PORT> --logout
   

3. 해당되는 대상 포털에 기타 볼륨이 없으면 추가 로그인 시도의 방지를 위해 대상 포털 레코드를 삭제하십시오.

   iscsiadm -m node -o delete -T <TARGET IQN> -p <PORTAL IP:PORT>
   

   자세한 내용은 ‘ iscsiadm ’ 매뉴얼 을 참조하십시오.