From: Patrick Donnelly <pdonnell@redhat.com>
Date: Fri, 5 Apr 2019 21:11:11 +0000 (-0700)
Subject: doc: add doc for blacklisting older CephFS clients
X-Git-Tag: v15.1.0~2983^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=19372b8492a75ea8423cb9826f4ddaec0a947554;p=ceph.git

doc: add doc for blacklisting older CephFS clients

Fixes: http://tracker.ceph.com/issues/39130
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
---

diff --git a/doc/cephfs/administration.rst b/doc/cephfs/administration.rst
index b7aa37cec6b9..a1ae02d6610f 100644
--- a/doc/cephfs/administration.rst
+++ b/doc/cephfs/administration.rst
@@ -213,6 +213,28 @@ does not change a MDS; it manipulates the file system rank which has been
 marked damaged.
 
 
+Minimum Client Version
+----------------------
+
+It is sometimes desirable to set the minimum version of Ceph that a client must be
+running to connect to a CephFS cluster. Older clients may sometimes still be
+running with bugs that can cause locking issues between clients (due to
+capability release). CephFS provides a mechanism to set the minimum
+client version:
+
+::
+
+    fs set <fs name> min_compat_client <release>
+
+For example, to only allow Nautilus clients, use:
+
+::
+
+    fs set cephfs min_compat_client nautilus
+
+Clients running an older version will be automatically evicted.
+
+
 Global settings
 ---------------