doc/cephfs: update about changing max_mds FS setting variable

Update the documentation for CephFs admininstration as well
troubleshooting.

Signed-off-by: Rishabh Dave <ridave@redhat.com>
(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 5760e67f73e64853347d9145f3b4e110d08c596c..07646bff06786ac4c00292de86032be4fd4fe256 100644 (file)
--- 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 <file system name> <var> <val>
+    ceph fs set <file system name> <var> <val> [--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.
 
 ::