src/ceph/doc/rbd/iscsi-requirements.rst

   1 ==========================
   2 iSCSI Gateway Requirements
   3 ==========================
   4
   5 To implement the Ceph iSCSI gateway there are a few requirements. It is recommended
   6 to use two to four iSCSI gateway nodes for a highly available Ceph iSCSI gateway
   7 solution.
   8
   9 For hardware recommendations, see the `Hardware Recommendation page <http://docs.ceph.com/docs/master/start/hardware-recommendations/>`_
  10 for more details.
  11
  12 .. note::
  13     On the iSCSI gateway nodes, the memory footprint of the RBD images
  14     can grow to a large size. Plan memory requirements accordingly based
  15     off the number RBD images mapped.
  16
  17 There are no specific iSCSI gateway options for the Ceph Monitors or
  18 OSDs, but it is important to lower the default timers for detecting
  19 down OSDs to reduce the possibility of initiator timeouts. The following
  20 configuration options are suggested for each OSD node in the storage
  21 cluster::
  22
  23         [osd]
  24         osd heartbeat grace = 20
  25         osd heartbeat interval = 5
  26
  27 -  Online Updating Using the Ceph Monitor
  28
  29    ::
  30
  31        ceph tell <daemon_type>.<id> injectargs '--<parameter_name> <new_value>'
  32
  33    ::
  34
  35        ceph tell osd.0 injectargs '--osd_heartbeat_grace 20'
  36        ceph tell osd.0 injectargs '--osd_heartbeat_interval 5'
  37
  38 -  Online Updating on the OSD Node
  39
  40    ::
  41
  42        ceph daemon <daemon_type>.<id> config set osd_client_watch_timeout 15
  43
  44    ::
  45
  46        ceph daemon osd.0 config set osd_heartbeat_grace 20
  47        ceph daemon osd.0 config set osd_heartbeat_interval 5
  48
  49 For more details on setting Ceph's configuration options, see the `Configuration page <http://docs.ceph.com/docs/master/rados/configuration/>`_.