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 <zac.dover@gmail.com>

diff --git a/doc/cephadm/upgrade.rst b/doc/cephadm/upgrade.rst
index 429f4f2803e04650677e0a4fcc858aad4db0235f..d2b609ea533f0c00b36697a30fb4769156e03021 100644 (file)
--- 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 a18695bcf03fae8a3d25242eb4480d75be0b7af0..0b2caf7ff38161578a908f17e3e7016ed47167ca 100644 (file)
--- 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
 ---------------