doc/rados: warn against lowering require_min_compat_client in read-balancer

Add a note that the value should not be lowered after being set, to
avoid accidentally breaking features that depend on a newer release.

Signed-off-by: Kefu Chai <k.chai@proxmox.com>

diff --git a/doc/rados/operations/read-balancer.rst b/doc/rados/operations/read-balancer.rst
index 2bd7182dfb2ef1313b57d71e9b48925fb2b22b64..ea6ef0afa7dfcb8dceffbdd78e44c85eb911bbe5 100644 (file)
--- a/doc/rados/operations/read-balancer.rst
+++ b/doc/rados/operations/read-balancer.rst
@@ -47,9 +47,10 @@ following command:
 
    ceph osd set-require-min-compat-client reef
 
-This command will fail if any pre-Reef clients or daemons are connected to
-the monitors. To see which client versions are in use, run the following
-command:
+Do not lower an already-higher value: that would prevent features that
+depend on a newer release from working.  This command will fail if any
+pre-Reef clients or daemons are connected to the Monitors. To see which
+client versions are in use, run the following command:
 
 .. prompt:: bash $