From 9b979a5c5d21d66bfd8ec69b5ad1d817ee9ecf78 Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Fri, 12 Apr 2019 16:41:38 -0500 Subject: [PATCH] doc/release/nautilus: proscribe minimum hammer tunables and straw2 on upgrade Signed-off-by: Sage Weil --- doc/rados/operations/balancer.rst | 3 +++ doc/releases/nautilus.rst | 22 ++++++++++++++++++++++ 2 files changed, 25 insertions(+) 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:: -- 2.39.5