From: Zac Dover <zac.dover@proton.me>
Date: Fri, 6 Sep 2024 13:31:21 +0000 (+1000)
Subject: doc/cephadm: add malformed-JSON removal instructions
X-Git-Tag: v19.2.1~235^2
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=78c8df84dec6ff3f4d229a51b23a972f0ed2e739;p=ceph.git

doc/cephadm: add malformed-JSON removal instructions

Add instructions for removing malformed JSON that causes the cephadm
module to fail to start, which in turn makes the orchestrator fail to
start.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 93d90ea358cf17b08e502caf8529061a10008fad)
---

diff --git a/doc/cephadm/upgrade.rst b/doc/cephadm/upgrade.rst
index 4ab48b69c416b..3a15c3ac6231d 100644
--- a/doc/cephadm/upgrade.rst
+++ b/doc/cephadm/upgrade.rst
@@ -131,7 +131,21 @@ doesn't use ``cephadm shell``) to a version compatible with the new version.
 Potential problems
 ==================
 
-There are a few health alerts that can arise during the upgrade process.
+
+Error: ENOENT: Module not found
+-------------------------------
+
+The message ``Error ENOENT: Module not found`` appears in response to the command ``ceph orch upgrade status`` if the orchestrator has crashed:
+
+.. prompt:: bash #
+
+   ceph orch upgrade status
+
+::
+
+   Error ENOENT: Module not found
+
+This is possibly caused by invalid JSON in a mgr config-key. See `Redmine tracker Issue #67329 <https://tracker.ceph.com/issues/67329>`_ and `the discussion on the [ceph-users] mailing list <https://www.spinics.net/lists/ceph-users/msg83667.html>`_.
 
 UPGRADE_NO_STANDBY_MGR
 ----------------------