From: Sage Weil Date: Fri, 12 Apr 2019 21:41:38 +0000 (-0500) Subject: doc/release/nautilus: proscribe minimum hammer tunables and straw2 on upgrade X-Git-Tag: v15.1.0~2920^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=9b979a5c5d21d66bfd8ec69b5ad1d817ee9ecf78;p=ceph-ci.git doc/release/nautilus: proscribe minimum hammer tunables and straw2 on upgrade Signed-off-by: Sage Weil --- diff --git a/doc/rados/operations/balancer.rst b/doc/rados/operations/balancer.rst index 120e29041fe..930ef0d8c20 100644 --- a/doc/rados/operations/balancer.rst +++ b/doc/rados/operations/balancer.rst @@ -1,3 +1,6 @@ + +.. _balancer: + Balancer ======== diff --git a/doc/releases/nautilus.rst b/doc/releases/nautilus.rst index 760e88d2baa..fd5fd3d495f 100644 --- a/doc/releases/nautilus.rst +++ b/doc/releases/nautilus.rst @@ -319,6 +319,28 @@ Instructions #. Verify the cluster is healthy with ``ceph health``. + If your CRUSH tunables are older than Hammer, Ceph will now issue a + health warning. If you see a health alert to that effect, you can + revert this change with:: + + ceph config set mon mon_crush_min_required_version firefly + + If Ceph does not complain, however, then we recommend you also + switch any existing CRUSH buckets to straw2, which was added back + in the Hammer release. If you have any 'straw' buckets, this will + result in a modest amount of data movement, but generally nothing + too severe.:: + + ceph osd getcrushmap -o backup-crushmap + ceph osd crush set-all-straw-buckets-to-straw2 + + If there are problems, you can easily revert with:: + + ceph osd setcrushmap -i backup-crushmap + + Moving to 'straw2' buckets will unlock a few recent features, like + the `crush-compat` :ref:`balancer ` mode added back in Luminous. + #. To enable the new :ref:`v2 network protocol `, issue the following command::