From: Patrick Donnelly Date: Thu, 2 May 2024 23:33:50 +0000 (-0400) Subject: doc/cephfs: document MDS_CLIENTS_BROKEN_ROOTSQUASH health error X-Git-Tag: v18.2.4~40 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=4f5d375f84d85ad1b94bb2c9fad0b0f26eabbdd8;p=ceph.git doc/cephfs: document MDS_CLIENTS_BROKEN_ROOTSQUASH health error Signed-off-by: Patrick Donnelly (cherry picked from commit b810bc9c54515b69aefffb36f1a47235b3c9125d) (cherry picked from commit 2f6dff5e5e80d5376d04897bbae72b7055a3b05b) --- diff --git a/doc/cephfs/health-messages.rst b/doc/cephfs/health-messages.rst index 8fb23715d2d3f..0f171c6ccc988 100644 --- a/doc/cephfs/health-messages.rst +++ b/doc/cephfs/health-messages.rst @@ -252,3 +252,20 @@ other daemons, please see :ref:`health-checks`. dirty data for cap revokes). If ``defer_client_eviction_on_laggy_osds`` is set to true (default true), client eviction will not take place and thus this health warning will be generated. + +``MDS_CLIENTS_BROKEN_ROOTSQUASH`` +--------------------------------- + Message + "X client(s) with broken root_squash implementation (MDS_CLIENTS_BROKEN_ROOTSQUASH)" + + Description + A bug was discovered in root_squash which would potentially lose changes made by a + client restricted with root_squash caps. The fix required a change to the protocol + and a client upgrade is required. + + This is a HEALTH_ERR warning because of the danger of inconsistency and lost + data. It is recommended to either upgrade your clients, discontinue using + root_squash in the interim, or silence the warning if desired. + + To evict and permanently block broken clients from connecting to the + cluster, set the ``required_client_feature`` bit ``client_mds_auth_caps``.