From bb842372b06209cc8ac61fcb19ef6abe71ba623e Mon Sep 17 00:00:00 2001 From: Kamoltat Sirivadhna Date: Sat, 7 Sep 2024 23:01:23 +0000 Subject: [PATCH] doc/rados/operations/stretch-mode.rst: Added Exitting Stretch Mode Added documentation about exiting stretch mode. Fixes: https://tracker.ceph.com/issues/67467 Signed-off-by: Kamoltat Sirivadhna (cherry picked from commit 0680f17d7bab386429a013c254dd90c70fbabeb7) --- doc/rados/operations/stretch-mode.rst | 28 +++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/doc/rados/operations/stretch-mode.rst b/doc/rados/operations/stretch-mode.rst index a5694718a58..ffb94e52943 100644 --- a/doc/rados/operations/stretch-mode.rst +++ b/doc/rados/operations/stretch-mode.rst @@ -247,6 +247,34 @@ possible, if needed). .. _Changing Monitor elections: ../change-mon-elections +Exiting Stretch Mode +===================== +To exit stretch mode, run the following command: + +.. prompt:: bash $ + + ceph mon disable_stretch_mode [{crush_rule}] --yes-i-really-mean-it + + +.. describe:: {crush_rule} + + The CRUSH rule that the user wants all pools to move back to. If this + is not specified, the pools will move back to the default CRUSH rule. + + :Type: String + :Required: No. + +The command will move the cluster back to normal mode, +and the cluster will no longer be in stretch mode. +All pools will move its ``size`` and ``min_size`` +back to the default values it started with. +At this point the user is responsible for scaling down the cluster +to the desired number of OSDs if they choose to operate with less number of OSDs. + +Please note that the command will not execute when the cluster is in +``recovery stretch mode``. The command will only execute when the cluster +is in ``degraded stretch mode`` or ``healthy stretch mode``. + Limitations of Stretch Mode =========================== When using stretch mode, OSDs must be located at exactly two sites. -- 2.47.3