From bfa7c14894ebab3ab58282782d8217438a3c4047 Mon Sep 17 00:00:00 2001 From: Kefu Chai Date: Thu, 27 Oct 2016 15:44:09 +0800 Subject: [PATCH] doc: add "to Hammer" upgrade section Fixes: http://tracker.ceph.com/issues/17534 Signed-off-by: Kefu Chai --- doc/install/upgrading-ceph.rst | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/doc/install/upgrading-ceph.rst b/doc/install/upgrading-ceph.rst index b97a6d30bcb1..d0ff8661158c 100644 --- a/doc/install/upgrading-ceph.rst +++ b/doc/install/upgrading-ceph.rst @@ -473,6 +473,20 @@ details. To upgrade from a post-Emperor point release, see the `Firefly release notes`_ for details. +Upgrading to Hammer +=================== + +When upgrading from v0.94.6 (and lower) to Hammer (v0.94.7 and higher), you need +to upgrade the OSD **before** the monitors. + +Due to changes in encoding of osdmap in v0.94.7, upgrading monitors before OSDs +can lead to serious performance issues on large clusters that contain hundreds of +OSDs. So, we should upgrade OSDs first to work around this issue. It is fixed +in Jewel and higher versions of Ceph. So you can follow the general steps when +upgrading from Hammer to Jewel, or from Jewel to Kraken. + + + Ceph Config File Changes ------------------------ @@ -748,4 +762,4 @@ Under those directories, the keyring should be in a file named ``keyring``. .. _Operating a Cluster: ../../rados/operations/operating .. _Monitoring a Cluster: ../../rados/operations/monitoring .. _Firefly release notes: ../../release-notes/#v0-80-firefly -.. _release notes: ../../release-notes \ No newline at end of file +.. _release notes: ../../release-notes -- 2.47.3