From 63de634b784e130764a97aff9bd3f58212770f15 Mon Sep 17 00:00:00 2001 From: Rishabh Dave Date: Fri, 19 Apr 2024 16:58:30 +0530 Subject: [PATCH] doc/cephfs: mention need of confirmation for "ceph mds fail" Update docs since command "ceph mds fail" will now fail if MDS has either health warning MDS_TRIM or MDS_CACHE_OVERSIZED and if confirmation flag is not passed. Signed-off-by: Rishabh Dave (cherry picked from commit dea22203749bc87a209289f5aed1e78b503ab440) --- doc/cephfs/add-remove-mds.rst | 7 +++++++ doc/cephfs/administration.rst | 6 +++++- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/cephfs/add-remove-mds.rst b/doc/cephfs/add-remove-mds.rst index 4f5ee06aa8b72..240d4d01c91c9 100644 --- a/doc/cephfs/add-remove-mds.rst +++ b/doc/cephfs/add-remove-mds.rst @@ -115,4 +115,11 @@ the following method. $ sudo rm -rf /var/lib/ceph/mds/ceph-${id} + +.. note:: When an active MDS either has health warning MDS_TRIM or + MDS_CACHE_OVERSIZED, confirmation flag (--yes-i-really-mean-it) + needs to be passed, else the command will fail. It is not recommended to + restart an MDS which has these warnings since slow recovery at restart may + lead to more problems. + .. _MDS Config Reference: ../mds-config-ref diff --git a/doc/cephfs/administration.rst b/doc/cephfs/administration.rst index d2f3452d1ad0f..4077457b78798 100644 --- a/doc/cephfs/administration.rst +++ b/doc/cephfs/administration.rst @@ -210,7 +210,11 @@ respawn as standbys. The file system will be left in a degraded state. :: # For all ranks, 0-N: - ceph mds fail : + ceph mds fail : {--yes-i-really-mean-it} + +.. note:: Note that confirmation flag is optional because it is only required + when the MDS is active and has health warning MDS_TRIM or + MDS_CACHE_OVERSIZED. Once all ranks are inactive, the file system may also be deleted or left in this state for other purposes (perhaps disaster recovery). -- 2.39.5