ceph/doc/rbd/iscsi-initiator-linux.rst

   1 -------------------------
   2 iSCSI Initiator for Linux
   3 -------------------------
   4
   5 **Prerequisite:**
   6
   7 -  Package ``iscsi-initiator-utils``
   8
   9 -  Package ``device-mapper-multipath``
  10
  11 **Installing:**
  12
  13 Install the iSCSI initiator and multipath tools:
  14
  15    ::
  16
  17        # yum install iscsi-initiator-utils
  18        # yum install device-mapper-multipath
  19
  20 **Configuring:**
  21
  22 #. Create the default ``/etc/multipath.conf`` file and enable the
  23    ``multipathd`` service:
  24
  25    ::
  26
  27        # mpathconf --enable --with_multipathd y
  28
  29 #. Add the following to ``/etc/multipath.conf`` file:
  30
  31    ::
  32
  33        devices {
  34                device {
  35                        vendor                 "LIO-ORG"
  36                        product                "TCMU device"
  37                        hardware_handler       "1 alua"
  38                        path_grouping_policy   "failover"
  39                        path_selector          "queue-length 0"
  40                        failback               60
  41                        path_checker           tur
  42                        prio                   alua
  43                        prio_args              exclusive_pref_bit
  44                        fast_io_fail_tmo       25
  45                        no_path_retry          queue
  46                }
  47        }
  48
  49 #. Restart the ``multipathd`` service:
  50
  51    ::
  52
  53        # systemctl reload multipathd
  54
  55 **iSCSI Discovery and Setup:**
  56
  57 #. If CHAP was setup on the iSCSI gateway, provide a CHAP username and
  58    password by updating the ``/etc/iscsi/iscsid.conf`` file accordingly.
  59
  60 #. Discover the target portals:
  61
  62    ::
  63
  64        # iscsiadm -m discovery -t st -p 192.168.56.101
  65        192.168.56.101:3260,1 iqn.2003-01.org.linux-iscsi.rheln1
  66        192.168.56.102:3260,2 iqn.2003-01.org.linux-iscsi.rheln1
  67
  68 #. Login to target:
  69
  70    ::
  71
  72        # iscsiadm -m node -T iqn.2003-01.org.linux-iscsi.rheln1 -l
  73
  74 **Multipath IO Setup:**
  75
  76 The multipath daemon (``multipathd``), will set up devices automatically
  77 based on the ``multipath.conf`` settings. Running the ``multipath``
  78 command show devices setup in a failover configuration with a priority
  79 group for each path.
  80
  81 ::
  82
  83     # multipath -ll
  84     mpathbt (360014059ca317516a69465c883a29603) dm-1 LIO-ORG ,IBLOCK
  85     size=1.0G features='0' hwhandler='1 alua' wp=rw
  86     |-+- policy='queue-length 0' prio=50 status=active
  87     | `- 28:0:0:1 sde  8:64  active ready running
  88     `-+- policy='queue-length 0' prio=10 status=enabled
  89       `- 29:0:0:1 sdc  8:32  active ready running
  90
  91 You should now be able to use the RBD image like you would a normal
  92 multipath’d iSCSI disk.
  93
  94 4. Logout from target:
  95
  96    ::
  97
  98       # iscsiadm -m node -T iqn.2003-01.org.linux-iscsi.rheln1 -u