]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/cephfs: edit troubleshooting.rst 64981/head
authorZac Dover <zac.dover@proton.me>
Tue, 12 Aug 2025 06:44:05 +0000 (16:44 +1000)
committerZac Dover <zac.dover@proton.me>
Thu, 14 Aug 2025 08:36:09 +0000 (18:36 +1000)
Edit the "Mount 5 Error" and "Mount 12 Error" sections of
doc/cephfs/troubleshooting.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
doc/cephfs/troubleshooting.rst

index 609d4ab019f4b479ff7070d0fd8299166d214f7a..e3f023fb513df42fac7380c08a48dd1a175940fc 100644 (file)
@@ -352,25 +352,32 @@ Mounting
 Mount 5 Error
 -------------
 
-A mount 5 error typically occurs if a MDS server is laggy or if it crashed.
-Ensure at least one MDS is up and running, and the cluster is ``active +
+A ``mount 5`` error indicates a lagging MDS server or a crashed MDS server.
+
+Ensure that at least one MDS is up and running, and the cluster is ``active +
 healthy``. 
 
 Mount 12 Error
 --------------
 
-A mount 12 error with ``cannot allocate memory`` usually occurs if you  have a
+A mount 12 error with a message reading ``cannot allocate memory`` indicates a
 version mismatch between the :term:`Ceph Client` version and the :term:`Ceph
-Storage Cluster` version. Check the versions using::
+Storage Cluster` version. Check the versions using the following command:
+
+.. prompt:: bash #
 
-       ceph -v
+   ceph -v
        
-If the Ceph Client is behind the Ceph cluster, try to upgrade it::
+If the Ceph Client is of an older version than the Ceph cluster, upgrade
+the Client:
+
+.. prompt:: bash #
 
-       sudo apt-get update && sudo apt-get install ceph-common 
+   sudo apt-get update && sudo apt-get install ceph-common 
 
-You may need to uninstall, autoclean and autoremove ``ceph-common`` 
-and then reinstall it so that you have the latest version.
+If this fails to resolve the problem, uninstall, autoclean, and autoremove the
+``ceph-common`` package and then reinstall it to ensure that you have the
+latest version of it.
 
 Dynamic Debugging
 =================