ceph/doc/rbd/iscsi-overview.rst

   1 .. _ceph-iscsi:
   2
   3 ==================
   4 Ceph iSCSI Gateway
   5 ==================
   6
   7 The iSCSI Gateway presents
   8 a Highly Available (HA) iSCSI target that exports RADOS Block Device (RBD) images
   9 as SCSI disks. The iSCSI protocol allows clients (initiators) to send SCSI commands
  10 to storage devices (targets) over a TCP/IP network, enabling clients without
  11 native Ceph client support to access Ceph block storage.  These include
  12 Microsoft Windows and even BIOS.
  13
  14 Each iSCSI gateway exploits the Linux IO target kernel subsystem (LIO) to provide
  15 iSCSI protocol support. LIO utilizes userspace passthrough (TCMU) to interact
  16 with Ceph's librbd library and expose RBD images to iSCSI clients. With Ceph’s
  17 iSCSI gateway you can provision a fully integrated block-storage
  18 infrastructure with all the features and benefits of a conventional Storage Area
  19 Network (SAN).
  20
  21 .. ditaa::
  22                   Cluster Network (optional)
  23                  +-------------------------------------------+
  24                  |             |               |             |
  25              +-------+     +-------+       +-------+     +-------+
  26              |       |     |       |       |       |     |       |
  27              | OSD 1 |     | OSD 2 |       | OSD 3 |     | OSD N |
  28              |    {s}|     |    {s}|       |    {s}|     |    {s}|
  29              +-------+     +-------+       +-------+     +-------+
  30                  |             |               |             |
  31       +--------->|             |  +---------+  |             |<---------+
  32       :          |             |  |   RBD   |  |             |          :
  33       |          +----------------|  Image  |----------------+          |
  34       |           Public Network  |    {d}  |                           |
  35       |                           +---------+                           |
  36       |                                                                 |
  37       |                      +-------------------+                      |
  38       |   +--------------+   | iSCSI Initiators  |   +--------------+   |
  39       |   | iSCSI GW     |   |   +-----------+   |   | iSCSI GW     |   |
  40       +-->|  RBD Module  |<--+   | Various   |   +-->|  RBD Module  |<--+
  41           |              |   |   | Operating |   |   |              |
  42           +--------------+   |   | Systems   |   |   +--------------+
  43                              |   +-----------+   |
  44                              +-------------------+
  45
  46
  47 .. toctree::
  48   :maxdepth: 1
  49
  50   Requirements <iscsi-requirements>
  51   Configuring the iSCSI Target <iscsi-targets>
  52   Configuring the iSCSI Initiators <iscsi-initiators>
  53   Monitoring the iSCSI Gateways <iscsi-monitoring>