From: Sebastian Wagner <sewagner@redhat.com>
Date: Tue, 16 Nov 2021 11:52:20 +0000 (+0100)
Subject: doc/cephadm: OSD memory autotuning for hyperconverged
X-Git-Tag: v17.1.0~370^2
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=08fdb42082cbc771ba0dcf9af7f9662f1bdc718c;p=ceph-ci.git

doc/cephadm: OSD memory autotuning for hyperconverged

Signed-off-by: Sebastian Wagner <sewagner@redhat.com>
---

diff --git a/doc/cephadm/install.rst b/doc/cephadm/install.rst
index 61cfb4edc5e..dcde2b449c3 100644
--- a/doc/cephadm/install.rst
+++ b/doc/cephadm/install.rst
@@ -318,9 +318,21 @@ available and unused device:
 
 See :ref:`cephadm-deploy-osds` for more detailed instructions.
 
-In case the cluster runs on hardware that is used exclusively for
-Ceph, it is recommended to enable ``osd_memory_target_autotune``.
-See :ref:`osd_autotune`.
+Enabling OSD memory autotuning
+------------------------------
+
+It is recommended to enable ``osd_memory_target_autotune``. 
+in order to maximise the performance of the cluster. See :ref:`osd_autotune`.
+
+In case the cluster hardware is not exclusively used by Ceph (hyperconverged),
+reduce the memory consuption of Ceph like so:
+
+  .. prompt:: bash #
+
+    # hyperconverged only:
+    ceph config set mgr mgr/cephadm/autotune_memory_target_ratio 0.2
+
+Then enable memory autotuning:
 
   .. prompt:: bash #