doc/cephadm: Restoring the MON quorum

Fixes: https://tracker.ceph.com/issues/49214
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>

diff --git a/doc/cephadm/troubleshooting.rst b/doc/cephadm/troubleshooting.rst
index 5d7a29c3a0649ccfb6f2049146c5ea53b86838da..b6f224e1f5930a2648abc3e366a86da442970099 100644 (file)
--- a/doc/cephadm/troubleshooting.rst
+++ b/doc/cephadm/troubleshooting.rst
@@ -1,4 +1,3 @@
-
 Troubleshooting
 ===============
 
@@ -176,3 +175,28 @@ To access the admin socket, first enter the daemon container on the host::
 
     [root@mon1 ~]# cephadm enter --name <daemon-name>
     [ceph: root@mon1 /]# ceph --admin-daemon /var/run/ceph/ceph-<daemon-name>.asok config show
+
+
+Restoring the MON quorum
+------------------------
+
+In case the Ceph MONs cannot form a quorum, cephadm is not able
+to manage the cluster, until the quorum is restored. 
+
+In order to restore the MON quorum, remove unhealthy MONs
+form the monmap by following these steps:
+
+1. Stop all MONs. For each MON host::
+
+    ssh {mon-host}
+    cephadm unit --name mon.`hostname` stop
+
+
+2. Identify a surviving monitor and log in to that host::
+
+    ssh {mon-host} 
+    cephadm enter --name mon.`hostname`
+
+3. Follow the steps in :ref:`rados-mon-remove-from-unhealthy` 
+
+

diff --git a/doc/rados/operations/add-or-rm-mons.rst b/doc/rados/operations/add-or-rm-mons.rst
index b0edb199bd8da0714dd94cfd11d0b43a456cf383..124076d6e4aeead6a8f94ea32d8b85d4acbcd2e7 100644 (file)
--- a/doc/rados/operations/add-or-rm-mons.rst
+++ b/doc/rados/operations/add-or-rm-mons.rst
@@ -164,6 +164,7 @@ quorum.
        
 #. Remove the monitor entry from ``ceph.conf``. 
 
+.. _rados-mon-remove-from-unhealthy: 
 
 Removing Monitors from an Unhealthy Cluster
 -------------------------------------------
@@ -176,7 +177,7 @@ quorum.
 #. Stop all ``ceph-mon`` daemons on all monitor hosts. ::
 
        ssh {mon-host}
-       service ceph stop mon || stop ceph-mon-all
+       systemctl stop ceph-mon.target
        # and repeat for all mons
 
 #. Identify a surviving monitor and log in to that host. ::