From f9b9e146aae8994d6b20944e2ed05516140d021c Mon Sep 17 00:00:00 2001
From: Matan Breizman <mbreizma@redhat.com>
Date: Thu, 21 Jul 2022 17:47:05 +0000
Subject: [PATCH] doc/releases/octopus.rst: add release note for rados

Signed-off-by: Matan Breizman <mbreizma@redhat.com>
---
 doc/releases/octopus.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/doc/releases/octopus.rst b/doc/releases/octopus.rst
index 485f850f1b3..0ea7149674b 100644
--- a/doc/releases/octopus.rst
+++ b/doc/releases/octopus.rst
@@ -14,7 +14,18 @@ all users update to this release.
 Notable Changes
 ---------------
 
-Notable Changes
+* Octopus modified the SnapMapper key format from
+  <LEGACY_MAPPING_PREFIX><snapid>_<shardid>_<hobject_t::to_str()>
+  to
+  <MAPPING_PREFIX><pool>_<snapid>_<shardid>_<hobject_t::to_str()>
+  When this change was introduced, 94ebe0e also introduced a conversion
+  with a crucial bug which essentially destroyed legacy keys by mapping them
+  to
+  <MAPPING_PREFIX><poolid>_<snapid>_
+  without the object-unique suffix. The conversion is fixed in this release.
+  Relevant tracker: https://tracker.ceph.com/issues/5614
+
+Changelog
 ---------------
 
 * admin/doc-requirements: bump sphinx to 4.4.0 (`pr#45972 <https://github.com/ceph/ceph/pull/45972>`_, Kefu Chai)
-- 
2.39.5