From e18cfd14ab82a61455ee98ca6aaafba8c4aaef8b Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Tue, 12 Aug 2025 16:44:05 +1000 Subject: [PATCH] doc/cephfs: edit troubleshooting.rst Edit the "Mount 5 Error" and "Mount 12 Error" sections of doc/cephfs/troubleshooting.rst. Signed-off-by: Zac Dover (cherry picked from commit bcb542fde53275566e52c832ab74fa324920e715) --- doc/cephfs/troubleshooting.rst | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/doc/cephfs/troubleshooting.rst b/doc/cephfs/troubleshooting.rst index 8d47f4e4a68e8..77cc577cbfac3 100644 --- a/doc/cephfs/troubleshooting.rst +++ b/doc/cephfs/troubleshooting.rst @@ -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 ================= -- 2.39.5