ceph/doc/rbd/iscsi-requirements.rst
Lenz Grimmer 71e46887d4 doc: Updated dashboard iSCSI configuration, added labels
Added note about the requirement for the latest ceph-iscsi version
3 to the dashboard documentation. Added some doc references
and replaced some URLs in the iSCSI docs with reST labels instead.

Signed-off-by: Lenz Grimmer <lgrimmer@suse.com>
2019-03-31 13:32:15 -05:00

51 lines
1.5 KiB
ReStructuredText

==========================
iSCSI Gateway Requirements
==========================
To implement the Ceph iSCSI gateway there are a few requirements. It is recommended
to use two to four iSCSI gateway nodes for a highly available Ceph iSCSI gateway
solution.
For hardware recommendations, see :ref:`hardware-recommendations` for more
details.
.. note::
On the iSCSI gateway nodes, the memory footprint of the RBD images
can grow to a large size. Plan memory requirements accordingly based
off the number RBD images mapped.
There are no specific iSCSI gateway options for the Ceph Monitors or
OSDs, but it is important to lower the default timers for detecting
down OSDs to reduce the possibility of initiator timeouts. The following
configuration options are suggested for each OSD node in the storage
cluster::
[osd]
osd heartbeat grace = 20
osd heartbeat interval = 5
- Online Updating Using the Ceph Monitor
::
ceph tell <daemon_type>.<id> config set <parameter_name> <new_value>
::
ceph tell osd.0 config set osd_heartbeat_grace 20
ceph tell osd.0 config set osd_heartbeat_interval 5
- Online Updating on the OSD Node
::
ceph daemon <daemon_type>.<id> config set osd_client_watch_timeout 15
::
ceph daemon osd.0 config set osd_heartbeat_grace 20
ceph daemon osd.0 config set osd_heartbeat_interval 5
For more details on setting Ceph's configuration options, see
:ref:`configuring-ceph`.