diff options
| author | Rishabh Dave <ridave@redhat.com> | 2024-10-18 16:34:18 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-10-18 16:34:18 +0200 |
| commit | 8978b85bb063870ba9257877143c5f56a729586b (patch) | |
| tree | 7d0941ec775da18a1025ab83738a7fd0a287b8dd /doc/cephfs | |
| parent | Merge pull request #60331 from MaxKellermann/CodingStyle_fwd (diff) | |
| parent | PendingReleaseNotes: add a release note about confirm flag for max_mds (diff) | |
| download | ceph-8978b85bb063870ba9257877143c5f56a729586b.tar.xz ceph-8978b85bb063870ba9257877143c5f56a729586b.zip | |
Merge pull request #59420 from rishabh-d-dave/max-mds-confirm
mon,cephfs: require confirmation when changing max_mds on unhealthy cluster
Reviewed-by: Patrick Donnelly <pdonnell@redhat.com>
Reviewed-by: Venky Shankar <vshankar@redhat.com>
Diffstat (limited to 'doc/cephfs')
| -rw-r--r-- | doc/cephfs/administration.rst | 11 | ||||
| -rw-r--r-- | doc/cephfs/troubleshooting.rst | 5 |
2 files changed, 14 insertions, 2 deletions
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 <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. :: diff --git a/doc/cephfs/troubleshooting.rst b/doc/cephfs/troubleshooting.rst index 34de1b7501d..78d0a8f54d3 100644 --- a/doc/cephfs/troubleshooting.rst +++ b/doc/cephfs/troubleshooting.rst @@ -128,6 +128,11 @@ things to do: That prevents any clients from establishing new sessions with the MDS. +* **Dont tweak max_mds** Modifying the FS setting variable ``max_mds`` is + sometimes perceived as a good step during troubleshooting or recovery effort. + Instead, doing so might further destabilize the cluster. If ``max_mds`` must + be changed in such circumstances, run the command to change ``max_mds`` with + the confirmation flag (``--yes-i-really-mean-it``) Expediting MDS journal trim |