1
0
mirror of https://github.com/ceph/ceph synced 2024-12-17 17:05:42 +00:00
ceph/doc/rbd/iscsi-requirements.rst
John Spray 6fc92dc981 doc: replace injectargs usage with "config set"
Cleaner and easier.  Also implicitly documents
the config set command, which hadn't been explicitly
called out in the docs before.

Signed-off-by: John Spray <john.spray@redhat.com>
2017-11-07 11:32:26 +00:00

50 lines
1.6 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 the `Hardware Recommendation page <http://docs.ceph.com/docs/master/start/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 the `Configuration page <http://docs.ceph.com/docs/master/rados/configuration/>`_.