前置条件

• HBlock服务器端，已经成功创建卷。

• 准备Linux客户端

  1. 安装Linux客户端

     注意
     需要具有root权限才能配置initiator。
     

     若您客户端为 CentOS/RHEL，请安装iscsi-initiator-utils，安装命令如下：

     yum -y install iscsi-initiator-utils
     

     注意
     请安装iSCSI initiator 6.2.0-874-10 或以上版本。
     

     若您客户端为Ubuntu/Debian，安装命令如下：

     apt install open-iscsi
     

  2. 安装MPIO

     对于CentOS

     yum install device-mapper-multipath device-mapper-multipath-libs     #CentOS
     

     对于Ubuntu

     apt install multipath-tools   #Ubuntu
     

  3. 配置MPIO

     1. 复制 /usr/share/doc/device-mapper-multipath-X.Y.Z/multipath.conf （其中X.Y.Z为multipath的实际版本号）到 /etc/multipath.conf 。
     2. 在/etc/multipath.conf中增加如下配置：

     注意
     配置文件multipath.conf中，如果multipath部分与devices部分中有相同参数，multipath中的参数值会覆盖devices中的参数值。为了正常使用HBlock卷，需要删除multipath中的与下列字段相同的参数。
     

     defaults {
            user_friendly_names yes
            find_multipaths yes
            uid_attribute "ID_WWN"
     }
     devices {
            device {
                   vendor "CTYUN"
                   product "iSCSI LUN Device"
                   path_grouping_policy failover
                   path_checker tur
                   path_selector "round-robin 0"
                   hardware_handler "1 alua"
                   rr_weight priorities
                   no_path_retry queue
                   prio alua
            }
     }
     

  4. 重启multipathd服务

     • 对于CentOS

     systemctl restart multipathd   # CentOS
     systemctl enable multipathd
     

     • 对于Ubuntu

     systemctl restart multipath-tools.service   # Ubuntu
     

操作步骤

HBlock服务器端

查询要连接的LUN及LUN对应iSCSI Target的详细信息

./stor lun ls { -n | --name } LUN_NAME 
./stor target ls { -n | --name } TARGET_NAME

Linux客户端

1. 使用如下命令发现Target IQN。

   说明
   如果卷对应多个Target IQN，建议将这些Target IQN都连上。
   

   iscsiadm -m discovery -t st -p ACTIVE_IP
   iscsiadm -m discovery -t st -p STANDBY_IP
   iscsiadm -m discovery -t st -p ColdStandby_IP
   

2. 登录iSCSI存储：建立多个iSCSI连接（按Active Target、Standby Target、ColdStandby顺序连接）。

   说明
   若您的iSCSI Target没有开启CHAP认证，请直接执行步骤 d 登录 Target。
   

   1. 开启认证

      iscsiadm -m node -T iSCSI_TARGET_IQN -o update --name node.session.auth.authmethod --value=CHAP
      

   2. 输入CHAP用户名。

      iscsiadm -m node -T iSCSI_TARGET_IQN -o update --name node.session.auth.username --value=USER
      

   3. 输入CHAP密码。

      iscsiadm -m node -T iSCSI_TARGET_IQN -o update --name node.session.auth.password --value=PASSWORD
      

   4. 登录Target。

      iscsiadm -m node -T iSCSI_TARGET_IQN -p SERVER_IP:port -l   # port为iSCSI端口号
      

3. 设备显示会话情况，查看当前iSCSI连接。

   iscsiadm -m session
   lsscsi #查看新增磁盘
   

4. 查看 MPIO 设备、磁盘对应的LUN的WWID。

   multipath -ll          # 可增加参数-v 3，显示更详细的信息
   ll /dev/mapper/mpathX
   /lib/udev/scsi_id --whitelisted --device=/dev/sdX  # 可以查看iSCSI磁盘对应HBlock卷的WWID
   

5. 操作 MPIO 设备。

   将iSCSI磁盘分区挂载到本地目录上，挂载之后可以写入数据。

   lsblk
   mkfs -t ext4 /dev/mapper/mpathX     # 格式化成 ext4
   mkdir  DIRECTORY_NAME_OR_PATH   #创建目录
   mount /dev/mapper/mpathX DIRECTORY_NAME_OR_PATH  #将mpathX挂载到目录
   lsblk
   

   注意
   如果用户之前已经连接过此磁盘并完成了格式化，重新连接后无需再次进行磁盘格式化，直接挂载iSCSI磁盘即可。
   

   说明
   常用的文件系统有ext4、XFS，具体格式化成哪种文件系统要视用户文件系统决定。
   

   注意
   如果用户需要断开连接或者删除磁盘，执行下列步骤：
   确保在卸载文件系统之前，没有进程正在使用该文件系统的文件夹。
   使用sync命令来确保所有挂起的写操作都已写入磁盘。
   使用umount命令来正常卸载文件系统，断开iSCSI连接。
   

   umount DIRECTORY_NAME_OR_PATH
   iscsiadm -m node -T iSCSI_TARGET_IQN -p SERVER_IP -u 
   

   示例

   [root@client ~]# sync
   [root@client ~]# umount /mnt/disk_mpatha
   [root@client ~]# iscsiadm -m node -T iqn.2012-08.cn.ctyunapi.oos:target01.1 -p 192.168.0.102 -u
   Logging out of session [sid: 2, target: iqn.2012-08.cn.ctyunapi.oos:target01.1, portal: 192.168.0.102,3260]
   Logout of [sid: 2, target: iqn.2012-08.cn.ctyunapi.oos:target01.1, portal: 192.168.0.102,3260] successful. 
   [root@client ~]# iscsiadm -m node -T iqn.2012-08.cn.ctyunapi.oos:target01.2 -p 192.168.0.110 -u
   Logging out of session [sid: 3, target: iqn.2012-08.cn.ctyunapi.oos:target01.2, portal: 192.168.0.110,3260]
   Logout of [sid: 3, target: iqn.2012-08.cn.ctyunapi.oos:target01.2, portal: 192.168.0.110,3260] successful. 
   [root@client ~]# iscsiadm -m node -T iqn.2012-08.cn.ctyunapi.oos:target01.3 -p 192.168.0.192 -u
   Logging out of session [sid: 4, target: iqn.2012-08.cn.ctyunapi.oos:target01.3, portal: 192.168.0.192,3260]
   Logout of [sid: 4, target: iqn.2012-08.cn.ctyunapi.oos:target01.3, portal: 192.168.0.192,3260] successful.