Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc/rbd: tweaks for the LIO iSCSI gateway #18250

Merged
merged 1 commit into from
Oct 20, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion doc/rbd/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ devices simultaneously.
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/>
Expand Down
12 changes: 6 additions & 6 deletions doc/rbd/iscsi-initiator-esx.rst
Original file line number Diff line number Diff line change
@@ -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:**

Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,12 @@
------------------------------------------------
The iSCSI Initiator for Red Hat Enterprise Linux
------------------------------------------------
-------------------------
iSCSI Initiator for Linux
-------------------------

**Prerequisite:**

- Package ``iscsi-initiator-utils-6.2.0.873-35`` or newer must be
installed
- Package ``iscsi-initiator-utils``

- Package ``device-mapper-multipath-0.4.9-99`` or newer must be
installed
- Package ``device-mapper-multipath``

**Installing:**

Expand All @@ -22,7 +20,7 @@ Install the iSCSI initiator and multipath tools:
**Configuring:**

#. Create the default ``/etc/multipath.conf`` file and enable the
``multiapthd`` service:
``multipathd`` service:

::

Expand All @@ -42,7 +40,7 @@ Install the iSCSI initiator and multipath tools:
path_checker tur
prio alua
prio_args exclusive_pref_bit
fast_oi_fail_tmo 25
fast_io_fail_tmo 25
no_path_retry queue
}
}
Expand Down
6 changes: 3 additions & 3 deletions doc/rbd/iscsi-initiator-win.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
-----------------------------------------
The iSCSI Initiator for Microsoft Windows
-----------------------------------------
-------------------------------------
iSCSI Initiator for Microsoft Windows
-------------------------------------

**Prerequisite:**

Expand Down
13 changes: 10 additions & 3 deletions doc/rbd/iscsi-initiators.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <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>
18 changes: 0 additions & 18 deletions doc/rbd/iscsi-monitoring.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/rbd/iscsi-overview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -46,5 +46,5 @@ Network (SAN).

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>