Skip to content

Commit a26ae56

Browse files
committed
ceph: document bumping minimum client version
This can unlock some features on older clusters, such as the upmap balancer mode.
1 parent 5707bb2 commit a26ae56

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

doc/source/operations/upgrading-ceph.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,21 @@ versions``. Once confirmed, run the following command:
171171
172172
ceph config set osd bluestore_elastic_shared_blobs 0
173173
174+
Finally, verify the value of ``ceph osd get-require-min-compat-client``. On
175+
older Ceph deployments, it may still be set to ``jewel``, which would prevent
176+
using the `upmap balancer mode
177+
<https://docs.ceph.com/en/latest/rados/operations/balancer/#modes>`__ which
178+
requires ``luminous`` or later. Similarly, the more recent `read balancer
179+
<https://docs.ceph.com/en/latest/rados/operations/read-balancer/>`__ requires
180+
``reef``.
181+
182+
Run ``ceph features`` to identify client versions and consider setting the
183+
minimum to an appropriate value:
184+
185+
.. code-block:: console
186+
187+
ceph osd set-require-min-compat-client reef
188+
174189
Upgrade Cephadm
175190
===============
176191

0 commit comments

Comments
 (0)