Kernel Modules <rbd-ko>
Snapshots<rbd-snapshot>
Mirroring <rbd-mirroring>
- iSCSI Gateway <iscsi-overview>
+ LIO iSCSI Gateway <iscsi-overview>
QEMU <qemu-rbd>
libvirt <libvirt>
Cache Settings <rbd-config-ref/>
-----------------------------------
-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:**
#. 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
--- /dev/null
+-------------------------
+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.
+++ /dev/null
-------------------------------------------------
-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.
------------------------------------------
-The iSCSI Initiator for Microsoft Windows
------------------------------------------
+-------------------------------------
+iSCSI Initiator for Microsoft Windows
+-------------------------------------
**Prerequisite:**
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 <iscsi-initiator-rhel>
- The iSCSI Initiator for Microsoft Windows <iscsi-initiator-win>
- The iSCSI Initiator for VMware ESX <iscsi-initiator-esx>
+ Linux <iscsi-initiator-linux>
+ Microsoft Windows <iscsi-initiator-win>
+ VMware ESX <iscsi-initiator-esx>
**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
Requirements <iscsi-requirements>
Configuring the iSCSI Target <iscsi-targets>
- Configuring the iSCSI Initiator <iscsi-initiators>
+ Configuring the iSCSI Initiators <iscsi-initiators>
Monitoring the iSCSI Gateways <iscsi-monitoring>
projects / ceph.git / commitdiff