From: Sebastian Wagner <sebastian.wagner@suse.com>
Date: Mon, 15 Feb 2021 13:43:31 +0000 (+0100)
Subject: doc/cephadm: troubleshooting: manually deploy MGR
X-Git-Tag: v16.2.0~119^2~58
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=87388a15176217ddd886c4d3935c72fd48e7912b;p=ceph.git

doc/cephadm: troubleshooting: manually deploy MGR

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
(cherry picked from commit a4179acbce3b9e71abb526a5b46436d6a3b96c82)
---

diff --git a/doc/cephadm/install.rst b/doc/cephadm/install.rst
index 361007d17a16..3835da317da3 100644
--- a/doc/cephadm/install.rst
+++ b/doc/cephadm/install.rst
@@ -157,6 +157,8 @@ or run ``cephadm bootstrap -h`` to see all available options:
   the login info in its config database so other hosts added to the cluster
   may also make use of the authenticated registry.
 
+.. _cephadm-enable-cli:
+
 Enable Ceph CLI
 ===============
 
diff --git a/doc/cephadm/troubleshooting.rst b/doc/cephadm/troubleshooting.rst
index e222d8f2e42c..889d526bac26 100644
--- a/doc/cephadm/troubleshooting.rst
+++ b/doc/cephadm/troubleshooting.rst
@@ -247,4 +247,41 @@ form the monmap by following these steps:
 
 3. Follow the steps in :ref:`rados-mon-remove-from-unhealthy` 
 
+Manually deploying a MGR daemon
+-------------------------------
+
+cephadm requires a MGR daemon in order to manage the cluster. In case the cluster
+the last MGR of a cluster was removed, follow these steps in order to deploy 
+a MGR ``mgr.hostname.smfvfd`` on a random host of your cluster manually. 
+
+Disable the cephadm scheduler, in order to prevent cephadm from removing the new 
+MGR. See :ref:`cephadm-enable-cli`::
+
+  ceph config-key set mgr/cephadm/pause true
+
+Then get or create the auth entry for the new MGR::
+
+  ceph auth get-or-create mgr.hostname.smfvfd mon "profile mgr" osd "allow *" mds "allow *"
+
+Get the ceph.conf::
+
+  ceph config generate-minimal-conf
+
+Get the container image::
+
+  ceph config get "mgr.hostname.smfvfd" container_image
+
+Create a file ``config-json.json`` which contains the information neccessary to deploy
+the daemon:
+
+.. code-block:: json
+
+  {
+    "config": "# minimal ceph.conf for 8255263a-a97e-4934-822c-00bfe029b28f\n[global]\n\tfsid = 8255263a-a97e-4934-822c-00bfe029b28f\n\tmon_host = [v2:192.168.0.1:40483/0,v1:192.168.0.1:40484/0]\n",
+    "keyring": "[mgr.hostname.smfvfd]\n\tkey = V2VyIGRhcyBsaWVzdCBpc3QgZG9vZi4=\n"
+  }
+
+Deploy the daemon::
+
+  cephadm --image <container-image> deploy --fsid <fsid> --name mgr.hostname.smfvfd --config-json config-json.json