From: Jason Dillaman Date: Wed, 11 Oct 2017 16:02:55 +0000 (-0400) Subject: doc/rbd: tweaks for the LIO iSCSI gateway X-Git-Tag: v13.0.1~496^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F18250%2Fhead;p=ceph.git doc/rbd: tweaks for the LIO iSCSI gateway Fixes: http://tracker.ceph.com/issues/21763 Signed-off-by: Jason Dillaman --- diff --git a/doc/rbd/index.rst b/doc/rbd/index.rst index c297d0ded2e..3cdb7b5be4a 100644 --- a/doc/rbd/index.rst +++ b/doc/rbd/index.rst @@ -45,7 +45,7 @@ devices simultaneously. Kernel Modules Snapshots Mirroring - iSCSI Gateway + LIO iSCSI Gateway QEMU libvirt Cache Settings diff --git a/doc/rbd/iscsi-initiator-esx.rst b/doc/rbd/iscsi-initiator-esx.rst index 18dd5832289..a876f0b48e2 100644 --- a/doc/rbd/iscsi-initiator-esx.rst +++ b/doc/rbd/iscsi-initiator-esx.rst @@ -1,10 +1,10 @@ ----------------------------------- -The iSCSI Initiator for VMware ESX ----------------------------------- +------------------------------ +iSCSI Initiator for VMware ESX +------------------------------ **Prerequisite:** -- VMware ESX 6.0 or later +- VMware ESX 6.5 or later **iSCSI Discovery and Multipath Device Setup:** @@ -14,14 +14,14 @@ The iSCSI Initiator for VMware ESX #. In the General tab click the "Advanced" button and in the "Advanced Settings" set RecoveryTimeout to 25. -#. If CHAP was setup on the iSCSI gateway, in the General tab click the "CHAP…​" +#. If CHAP was setup on the iSCSI gateway, in the General tab click the "CHAP..." button. If CHAP is not being used, skip to step 4. #. On the CHAP Credentials windows, select “Do not use CHAP unless required by target”, and enter the "Name" and "Secret" values used on the initial setup for the iSCSI gateway, then click on the "OK" button. -#. On the Dynamic Discovery tab, click the "Add…​" button, and enter the IP address +#. On the Dynamic Discovery tab, click the "Add..." button, and enter the IP address and port of one of the iSCSI target portals. Click on the "OK" button. #. Close the iSCSI Initiator Properties window. A prompt will ask to rescan the diff --git a/doc/rbd/iscsi-initiator-linux.rst b/doc/rbd/iscsi-initiator-linux.rst new file mode 100644 index 00000000000..386a68fa340 --- /dev/null +++ b/doc/rbd/iscsi-initiator-linux.rst @@ -0,0 +1,88 @@ +------------------------- +iSCSI Initiator for Linux +------------------------- + +**Prerequisite:** + +- Package ``iscsi-initiator-utils`` + +- Package ``device-mapper-multipath`` + +**Installing:** + +Install the iSCSI initiator and multipath tools: + + :: + + # yum install iscsi-initiator-utils + # yum install device-mapper-multipath + +**Configuring:** + +#. Create the default ``/etc/multipath.conf`` file and enable the + ``multipathd`` service: + + :: + + # mpathconf --enable --with_multipathd y + +#. Add the following to ``/etc/multipath.conf`` file: + + :: + + devices { + device { + vendor "LIO-ORG" + hardware_handler "1 alua" + path_grouping_policy "failover" + path_selector "queue-length 0" + failback 60 + path_checker tur + prio alua + prio_args exclusive_pref_bit + fast_io_fail_tmo 25 + no_path_retry queue + } + } + +#. Restart the ``multipathd`` service: + + :: + + # systemctl reload multipathd + +**iSCSI Discovery and Setup:** + +#. Discover the target portals: + + :: + + # iscsiadm -m discovery -t -st 192.168.56.101 + 192.168.56.101:3260,1 iqn.2003-01.org.linux-iscsi.rheln1 + 192.168.56.102:3260,2 iqn.2003-01.org.linux-iscsi.rheln1 + +#. Login to target: + + :: + + # iscsiadm -m node -T iqn.2003-01.org.linux-iscsi.rheln1 -l + +**Multipath IO Setup:** + +The multipath daemon (``multipathd``), will set up devices automatically +based on the ``multipath.conf`` settings. Running the ``multipath`` +command show devices setup in a failover configuration with a priority +group for each path. + +:: + + # multipath -ll + mpathbt (360014059ca317516a69465c883a29603) dm-1 LIO-ORG ,IBLOCK + size=1.0G features='0' hwhandler='1 alua' wp=rw + |-+- policy='queue-length 0' prio=50 status=active + | `- 28:0:0:1 sde 8:64 active ready running + `-+- policy='queue-length 0' prio=10 status=enabled + `- 29:0:0:1 sdc 8:32 active ready running + +You should now be able to use the RBD image like you would a normal +multipath’d iSCSI disk. diff --git a/doc/rbd/iscsi-initiator-rhel.rst b/doc/rbd/iscsi-initiator-rhel.rst deleted file mode 100644 index 51248e46f79..00000000000 --- a/doc/rbd/iscsi-initiator-rhel.rst +++ /dev/null @@ -1,90 +0,0 @@ ------------------------------------------------- -The iSCSI Initiator for Red Hat Enterprise Linux ------------------------------------------------- - -**Prerequisite:** - -- Package ``iscsi-initiator-utils-6.2.0.873-35`` or newer must be - installed - -- Package ``device-mapper-multipath-0.4.9-99`` or newer must be - installed - -**Installing:** - -Install the iSCSI initiator and multipath tools: - - :: - - # yum install iscsi-initiator-utils - # yum install device-mapper-multipath - -**Configuring:** - -#. Create the default ``/etc/multipath.conf`` file and enable the - ``multiapthd`` service: - - :: - - # mpathconf --enable --with_multipathd y - -#. Add the following to ``/etc/multipath.conf`` file: - - :: - - devices { - device { - vendor "LIO-ORG" - hardware_handler "1 alua" - path_grouping_policy "failover" - path_selector "queue-length 0" - failback 60 - path_checker tur - prio alua - prio_args exclusive_pref_bit - fast_oi_fail_tmo 25 - no_path_retry queue - } - } - -#. Restart the ``multipathd`` service: - - :: - - # systemctl reload multipathd - -**iSCSI Discovery and Setup:** - -#. Discover the target portals: - - :: - - # iscsiadm -m discovery -t -st 192.168.56.101 - 192.168.56.101:3260,1 iqn.2003-01.org.linux-iscsi.rheln1 - 192.168.56.102:3260,2 iqn.2003-01.org.linux-iscsi.rheln1 - -#. Login to target: - - :: - - # iscsiadm -m node -T iqn.2003-01.org.linux-iscsi.rheln1 -l - -**Multipath IO Setup:** - -The multipath daemon (``multipathd``), will set up devices automatically -based on the ``multipath.conf`` settings. Running the ``multipath`` -command show devices setup in a failover configuration with a priority -group for each path. - -:: - - # multipath -ll - mpathbt (360014059ca317516a69465c883a29603) dm-1 LIO-ORG ,IBLOCK - size=1.0G features='0' hwhandler='1 alua' wp=rw - |-+- policy='queue-length 0' prio=50 status=active - | `- 28:0:0:1 sde 8:64 active ready running - `-+- policy='queue-length 0' prio=10 status=enabled - `- 29:0:0:1 sdc 8:32 active ready running - -You should now be able to use the RBD image like you would a normal -multipath’d iSCSI disk. diff --git a/doc/rbd/iscsi-initiator-win.rst b/doc/rbd/iscsi-initiator-win.rst index 08a1cfbde6f..c0f023b4180 100644 --- a/doc/rbd/iscsi-initiator-win.rst +++ b/doc/rbd/iscsi-initiator-win.rst @@ -1,6 +1,6 @@ ------------------------------------------ -The iSCSI Initiator for Microsoft Windows ------------------------------------------ +------------------------------------- +iSCSI Initiator for Microsoft Windows +------------------------------------- **Prerequisite:** diff --git a/doc/rbd/iscsi-initiators.rst b/doc/rbd/iscsi-initiators.rst index d3ad633480d..4dc992af948 100644 --- a/doc/rbd/iscsi-initiators.rst +++ b/doc/rbd/iscsi-initiators.rst @@ -2,9 +2,16 @@ Configuring the iSCSI Initiators -------------------------------- +- `iSCSI Initiator for Linux <../iscsi-initiator-linux>`_ + +- `iSCSI Initiator for Microsoft Windows <../iscsi-initiator-win>`_ + +- `iSCSI Initiator for VMware ESX <../iscsi-initiator-esx>`_ + .. toctree:: :maxdepth: 1 + :hidden: - The iSCSI Initiator for Red Hat Enterprise Linux - The iSCSI Initiator for Microsoft Windows - The iSCSI Initiator for VMware ESX + Linux + Microsoft Windows + VMware ESX diff --git a/doc/rbd/iscsi-monitoring.rst b/doc/rbd/iscsi-monitoring.rst index d4252323153..8a15dd73584 100644 --- a/doc/rbd/iscsi-monitoring.rst +++ b/doc/rbd/iscsi-monitoring.rst @@ -66,24 +66,6 @@ selects the LIO collector automatically. **Example ``gwtop`` Outputs** -For kernel RBD-based devices: - -:: - - gwtop 2/2 Gateways CPU% MIN: 4 MAX: 5 Network Total In: 2M Out: 3M 10:20:09 - Capacity: 8G Disks: 8 IOPS: 500 Clients: 1 Ceph: HEALTH_OK OSDs: 3 - Pool.Image Src Device Size r/s w/s rMB/s wMB/s await r_await w_await Client - iscsi.t1703 rbd0 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme1 rbd5 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme2 rbd2 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme3 rbd3 500M 0 0 0.00 0.00 0.00 0.00 0.00 - iscsi.testme5 rbd1 500M 0 0 0.00 0.00 0.00 0.00 0.00 - rbd.myhost_1 T rbd4 4G 500 0 1.95 0.00 2.37 2.37 0.00 rh460p(CON) - rbd.test_2 rbd6 1G 0 0 0.00 0.00 0.00 0.00 0.00 - rbd.testme rbd7 500M 0 0 0.00 0.00 0.00 0.00 0.00 - -For user backed storage (TCMU) devices: - :: gwtop 2/2 Gateways CPU% MIN: 4 MAX: 5 Network Total In: 2M Out: 3M 10:20:00 diff --git a/doc/rbd/iscsi-overview.rst b/doc/rbd/iscsi-overview.rst index a8c64e2069d..9049c218531 100644 --- a/doc/rbd/iscsi-overview.rst +++ b/doc/rbd/iscsi-overview.rst @@ -46,5 +46,5 @@ Network (SAN). Requirements Configuring the iSCSI Target - Configuring the iSCSI Initiator + Configuring the iSCSI Initiators Monitoring the iSCSI Gateways