]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/rados/operations/stretch-mode.rst: Added Exitting Stretch Mode
authorKamoltat Sirivadhna <ksirivad@redhat.com>
Sat, 7 Sep 2024 23:01:23 +0000 (23:01 +0000)
committerroot <root@vossi06.front.sepia.ceph.com>
Tue, 5 Nov 2024 19:08:29 +0000 (19:08 +0000)
Added documentation about exiting stretch mode.

Fixes: https://tracker.ceph.com/issues/67467
Signed-off-by: Kamoltat Sirivadhna <ksirivad@redhat.com>
(cherry picked from commit 0680f17d7bab386429a013c254dd90c70fbabeb7)

doc/rados/operations/stretch-mode.rst

index a5694718a5847cdba74ef092f2b97cafd6ca44ae..ffb94e52943d6ca9cec856837b991c2791cbe4a2 100644 (file)
@@ -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.