Fix some bugs when testing opensds ansible
[stor4nfv.git] / src / ceph / doc / rbd / iscsi-overview.rst
1 ==================
2 Ceph iSCSI Gateway
3 ==================
4
5 The iSCSI gateway is integrating Ceph Storage with the iSCSI standard to provide
6 a Highly Available (HA) iSCSI target that exports RADOS Block Device (RBD) images
7 as SCSI disks. The iSCSI protocol allows clients (initiators) to send SCSI commands
8 to SCSI storage devices (targets) over a TCP/IP network. This allows for heterogeneous
9 clients, such as Microsoft Windows, to access the Ceph Storage cluster.
10
11 Each iSCSI gateway runs the Linux IO target kernel subsystem (LIO) to provide the
12 iSCSI protocol support. LIO utilizes a userspace passthrough (TCMU) to interact
13 with Ceph's librbd library and expose RBD images to iSCSI clients. With Ceph’s
14 iSCSI gateway you can effectively run a fully integrated block-storage
15 infrastructure with all the features and benefits of a conventional Storage Area
16 Network (SAN).
17
18 .. ditaa::
19                   Cluster Network
20                  +-------------------------------------------+
21                  |             |               |             |
22              +-------+     +-------+       +-------+     +-------+
23              |       |     |       |       |       |     |       |
24              | OSD 1 |     | OSD 2 |       | OSD 3 |     | OSD N |
25              |    {s}|     |    {s}|       |    {s}|     |    {s}|
26              +-------+     +-------+       +-------+     +-------+
27                  |             |               |             |
28       +--------->|             |  +---------+  |             |<---------+
29       :          |             |  |   RBD   |  |             |          :
30       |          +----------------|  Image  |----------------+          |
31       |           Public Network  |    {d}  |                           |
32       |                           +---------+                           |
33       |                                                                 |
34       |                      +-------------------+                      |
35       |   +--------------+   |  iSCSI Initators  |   +--------------+   |
36       |   | iSCSI GW     |   |   +-----------+   |   | iSCSI GW     |   |
37       +-->|  RBD Module  |<--+   | Various   |   +-->|  RBD Module  |<--+
38           |              |   |   | Operating |   |   |              |
39           +--------------+   |   | Systems   |   |   +--------------+
40                              |   +-----------+   |
41                              +-------------------+
42
43
44 .. toctree::
45   :maxdepth: 1
46
47   Requirements <iscsi-requirements>
48   Configuring the iSCSI Target <iscsi-targets>
49   Configuring the iSCSI Initiator <iscsi-initiators>
50   Monitoring the iSCSI Gateways <iscsi-monitoring>