개요

DBMS 를 ISCSI Multipath 환경에서 구동 및 테스트 를 해야하는 분들을 위해 환경을 간단히 구축해보는 예시입니다. 

방법

구성 예시 환경

ISCSI 는 스토리지를 제공해줄 Target 서버, 스토리지를 받을 Initiator 로 구성하게 됩니다.

해당 예시는 같은 디스크에 여러 경로를 구축해야 함으로 Initiator 가 Target 으로 통신 가능한 IP 2개를 Target 에 준비 되야합니다.

만약 Multipath 구성이 아니라 스토리지 만 할당 받을 예정이면 단일 IP 로 Target 을 준비해도 가능합니다.

단일 Disk 전체를 Target 에 준비하는게 아닌 파티셔닝된 볼륨으로도 진행해도 되지만,

해당 문서에선 Multipath 구축 위한 간단한 환경이므로 단일 Disk 를 LUN 을 할당합니다.

ISCSI Target 구성 목표

디스크 준비 내용

/dev/sdc, /dev/sdb 에 각 20기가 디스크 장착을 준비합니다.

ISCSI Target 구축을 위한 targetcli 패키지 설치

yum install targetcli -y

targetcli 명령어 통해 설치 확인

targetcli

<targetcli ls 명령어 조회 결과 화면>

디스크 Object 생성

/> /backstores/block create iscsi_disk01 /dev/sdb

/> /backstores/block create iscsi_disk02 /dev/sdc

<잘못된 설정 의 경우 에러 매시지 출력>

디스크 Object 추가 확인 은 ls 명령어 통해 할당 결과 확인 가능합니다.

iqn 생성

iqn 을 생성하게 되면 해당 서버의 고유 주소를  만드는 과정입니다.

• iqn을 생성하게되면 tpg 를 함께 생성합니다. 
• tpg 는 target portal group. initiator들이 target에 연결될 수 있도록 하는 설정들의 그룹 을 의미합니다.

/iscsi create iqn.2025-10.com.ps1.tibero:server1

ls 조회 결과 iqn 이 할당됨을 확인가능 합니다.

ACL (Access Control List) 생성

iscsi target에 접속 허용할 initator 리스트 를 ACL 로 지정가능합니다.

tpg1 으로 이동

/> cd /iscsi/iqn.2025-10.com.ps1.tibero:server1/tpg1/

/> acls/ create iqn.2025-10.com.ps1.tibero:client1

외부 접근 위해 기본 포탈 아이피 변경

cd portals
delete 0.0.0.0 3260
create 10.0.10.4 3260
create 10.0.10.5 3260

lun 생성

처음 생성한 디스크 오브잭트에 lun 을 생성해 매핑 합니다.

해당 이름으로 target 에 제공하게 됩니다.

/> cd /iscsi/iqn.2025-10.com.ps1.tibero:server1/tpg1/

생성한 disk object 로 lun 생성수행

cd /iscsi/iqn.2025-10.com.ps1.tibero:server1/tpg1/
luns/ create  생성한 볼륨 오브잭트이름

/> /iscsi/iqn.20...:server1/tpg1> luns/ create /backstores/block/iscsi_disk01
/> /iscsi/iqn.20...:server1/tpg1> luns/ create /backstores/block/iscsi_disk02

결과 조회

• /dev/sdb → lun0 할당
• /dev/sdc → lun1 할당
• portals 10.0.10.3, 10.0.10.5 확인

ISCSI Portal Ip 와 IQN 을 활용해 Initiator 에서 스토리지를 할당 받을 수 있는 상태

Initiator (클라이언트) 설정

아래 과정은 Initiator  서버에서 수행하여 디스크를 할당 받아 올 수 있게 설정합니다.

LUN 을 할당 받을 isci initiator 패키지 설치

yum install iscsi-initiator-utils -y

데몬 활성화

systemctl enable --now iscsi iscsid

target 에서 지정한 IQN 확인

 vi /etc/iscsi/initiatorname.iscsi

아래 내용으로 편집

InitiatorName=iqn.2025-10.com.ps1.tibero:client1

확인

cat /etc/iscsi/initiatorname.iscsi

target 검색

iscsiadm -m discovery --type sendtargets --portal 10.0.10.3

필요하다면 방화벽 해제

systemctl stop firewalld
systemctl disable firewalld

target 에 로그인

iscsiadm -m node -T iqn.2025-10.com.ps1.tibero:server1 --login

두 개경로 테스트 (연결 확인)

iscsiadm -m node -T iqn.2025-10.com.ps1.tibero:server1 -l -p 10.0.10.3

iscsiadm -m node -T iqn.2025-10.com.ps1.tibero:server1 -l -p 10.0.10.5

같은 디스크 가 다른 이름으로 할당됩을 알수 있습니다.

lsscsi

iscsi 세션 확인

iscsiadm -m session -o show

두개의 Device의 wwid 값이 같음을 확인(타겟 Device가 사실상 같은 Device임을 의미)

/lib/udev/scsi_id -g -u -d /dev/sdb

/lib/udev/scsi_id -g -u -d /dev/sdd

할당받은 ISCSI 디스크로 멀티패스 구성 수행

멀티패스 패키지 설정

yum install device-mapper-multipath -y

설치 확인

multipath -ll

multipath.conf example file 을 /etc/multipath.conf 로 복사 및 편집

cp /usr/share/doc/device-mapper-multipath/multipath.conf /etc/

vi /etc/multipath.conf

sdb 와 sdd 를 멀티패스로 묶을거고 sdc 와 sde 를 멀티패스로 묶을거다

[root@localhost ~]# /lib/udev/scsi_id -g -u -d /dev/sdb
36001405f455cae7657d4377812f36455
[root@localhost ~]# /lib/udev/scsi_id -g -u -d /dev/sdd
36001405f455cae7657d4377812f36455
[root@localhost ~]# /lib/udev/scsi_id -g -u -d /dev/sdc
3600140541a58a71120e4102a678cb7ae
[root@localhost ~]# /lib/udev/scsi_id -g -u -d /dev/sde
3600140541a58a71120e4102a678cb7ae

rocky 9에서 multipath v0.8.7가 설치되었는데, wwid "" 는 parsing error 가 발생 한다면*

wwid "."*정규표현식을 통해 전체 wwid를 blacklist에 등록

devnode로 blacklist에 등록하면, 예외처리시 wwid로 예외처리가 안됩니다.

devnode blacklist는 devnode로 예외처리

wwid blacklist는 wwid로 예외처리를 합니다.

설정 예시

blacklist {
       wwid 26353900f02796769
       devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
       devnode "^hd[a-z]"
}

multipaths {
        multipath {
                wwid    36001405f455cae7657d4377812f36455
                path_grouping_policy    multibus
                failback                manual
                rr_weight               priorities
                no_path_retry           5
        }
        multipath {
                wwid    3600140541a58a71120e4102a678cb7ae
                path_grouping_policy    multibus
                failback                manual
                rr_weight               priorities
                no_path_retry           5
        }
}

user_friendly_names - yes 사용 시 mpathX 의 명칭을 사용하여 multipath 디바이스를 생성합니다.

멀티패스 서비스 시작

service multipathd start

시작후 lsblk 조회 시 멀티 패스로 묶인걸 확인가능

lsblk

멀티패스 조회

 multipath -ll

fdisk 상 멀티패스 확인 가능

참조

[Linux] Device-Mapper multipath 설정 상세 (multipath.conf 파라미터)