From 73070f69603e7f6442bbf3afe19a84e8b8e98b57 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Sun, 31 Oct 2021 01:56:44 +1000 Subject: [PATCH] doc/cephadm: add admonition for tracker 53062 NOTE: This commit also adds an admonition to the pacific.rst page, in the /releases directory. This commit warns users not to upgrade to Ceph v16 (Pacific). Upgrading to v16 (Pacific) can cause data corruption. This commit has been made in response to https://tracker.ceph.com/issues/53062 and in response to Stefan Kooman's urgent request that we update the documentation, adding a warning to the documentation to prevent users from upgrading to v16.2.6. Signed-off-by: Zac Dover --- doc/cephadm/upgrade.rst | 23 ++++++++++++++++++ doc/releases/pacific.rst | 52 ++++++++++++++++++++++++++++++++++++++-- 2 files changed, 73 insertions(+), 2 deletions(-) diff --git a/doc/cephadm/upgrade.rst b/doc/cephadm/upgrade.rst index 429f4f2803e..d2b609ea533 100644 --- a/doc/cephadm/upgrade.rst +++ b/doc/cephadm/upgrade.rst @@ -2,6 +2,29 @@ Upgrading Ceph ============== +.. DANGER:: DATE: 01 NOV 2021. + + DO NOT UPGRADE TO CEPH PACIFIC FROM AN OLDER VERSION. + + A recently-discovered bug (https://tracker.ceph.com/issues/53062) can cause + data corruption. This bug occurs during OMAP format conversion for + clusters that are updated to Pacific. New clusters are not affected by this + bug. + + The trigger for this bug is BlueStore's repair/quick-fix functionality. This + bug can be triggered in two known ways: + + (1) manually via the ceph-bluestore-tool, or + (2) automatically, by OSD if ``bluestore_fsck_quick_fix_on_mount`` is set + to true. + + The fix for this bug is expected to be available in Ceph v16.2.7. + + DO NOT set ``bluestore_quick_fix_on_mount`` to true. If it is currently + set to true in your configuration, immediately set it to false. + + DO NOT run ``ceph-bluestore-tool``'s repair/quick-fix commands. + Cephadm can safely upgrade Ceph from one bugfix release to the next. For example, you can upgrade from v15.2.0 (the first Octopus release) to the next point release, v15.2.1. diff --git a/doc/releases/pacific.rst b/doc/releases/pacific.rst index a18695bcf03..0b2caf7ff38 100644 --- a/doc/releases/pacific.rst +++ b/doc/releases/pacific.rst @@ -5,11 +5,59 @@ Pacific Pacific is the 16th stable release of Ceph. It is named after the giant pacific octopus (Enteroctopus dofleini). +.. DANGER:: DATE: 01 NOV 2021. + + DO NOT UPGRADE TO CEPH PACIFIC FROM AN OLDER VERSION. + + A recently-discovered bug (https://tracker.ceph.com/issues/53062) can cause + data corruption. This bug occurs during OMAP format conversion for + clusters that are updated to Pacific. New clusters are not affected by this + bug. + + The trigger for this bug is BlueStore's repair/quick-fix functionality. This + bug can be triggered in two known ways: + + (1) manually via the ceph-bluestore-tool, or + (2) automatically, by OSD if ``bluestore_fsck_quick_fix_on_mount`` is set + to true. + + The fix for this bug is expected to be available in Ceph v16.2.7. + + DO NOT set ``bluestore_quick_fix_on_mount`` to true. If it is currently + set to true in your configuration, immediately set it to false. + + DO NOT run ``ceph-bluestore-tool``'s repair/quick-fix commands. + + v16.2.6 Pacific =============== -This is the sixth backport release in the Pacific series. We recommend all -users update to this release. +.. DANGER:: DATE: 01 NOV 2021. + + DO NOT UPGRADE TO CEPH PACIFIC FROM AN OLDER VERSION. + + A recently-discovered bug (https://tracker.ceph.com/issues/53062) can cause + data corruption. This bug occurs during OMAP format conversion for + clusters that are updated to Pacific. New clusters are not affected by this + bug. + + The trigger for this bug is BlueStore's repair/quick-fix functionality. This + bug can be triggered in two known ways: + + (1) manually via the ceph-bluestore-tool, or + (2) automatically, by OSD if ``bluestore_fsck_quick_fix_on_mount`` is set + to true. + + The fix for this bug is expected to be available in Ceph v16.2.7. + + DO NOT set ``bluestore_quick_fix_on_mount`` to true. If it is currently + set to true in your configuration, immediately set it to false. + + DO NOT run ``ceph-bluestore-tool``'s repair/quick-fix commands. + + +This is the sixth backport release in the Pacific series. + Notable Changes --------------- -- 2.39.5