From: Rishabh Dave Date: Tue, 27 Aug 2024 08:03:23 +0000 (+0530) Subject: doc/cephfs: update about changing max_mds FS setting variable X-Git-Tag: testing/wip-jcollin-testing-20251001.014437-squid^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=90632e50b976b0d371b85819f9e9341fc63be83e;p=ceph-ci.git doc/cephfs: update about changing max_mds FS setting variable Update the documentation for CephFs admininstration as well troubleshooting. Signed-off-by: Rishabh Dave (cherry picked from commit 2d28faaeea11988867471a53e40145f309951307) Conflicts: doc/cephfs/troubleshooting.rst - This patch was skipped because it was (erroneously) included by a different PR author in its PR. --- diff --git a/doc/cephfs/administration.rst b/doc/cephfs/administration.rst index 5760e67f73e..07646bff067 100644 --- a/doc/cephfs/administration.rst +++ b/doc/cephfs/administration.rst @@ -61,10 +61,17 @@ is a subset of the same information from the ``ceph fs dump`` command. :: - ceph fs set + ceph fs set [--yes-i-really-mean-it] Change a setting on a file system. These settings are specific to the named -file system and do not affect other file systems. +file system and do not affect other file systems. Confirmation flag is only +needed for changing ``max_mds`` when cluster is unhealthy. + +.. note:: It is mandatory to pass confirmation flag (--yes--i-really-mean-it) + for modifying FS setting variable ``max_mds`` when cluster is unhealthy. + It has been added a precaution to tell users that modifying ``max_mds`` + during troubleshooting or recovery might not help. Instead, it might + further destabilize the cluster. ::