DOCSP-22394 add compatibility note for fcv and clustered collections (#1039)

jason-price-mongodb · jason-price-mongodb · web-flow · commit e78fccb91a76 · 2022-05-03T12:28:41.000-07:00
* DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections * DOCSP-22394-add-compatibility-note-for-FCV-and-clustered-collections Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
diff --git a/source/core/clustered-collections.txt b/source/core/clustered-collections.txt
@@ -81,6 +81,11 @@ from secondary indexes:
   collection size returned by the :dbcommand:`collStats` command
   includes the clustered index size.
 
+.. important:: Backward-Incompatible Feature
+
+   You must drop clustered collections before you can downgrade to
+   a version of MongoDB earlier than 5.3.
+
 Limitations
 -----------
 
diff --git a/source/includes/downgrade-for-clustered-collections.rst b/source/includes/downgrade-for-clustered-collections.rst
@@ -0,0 +1,3 @@
+Starting in MongoDB 5.3, if you are using :ref:`clustered collections
+<clustered-collections>`, you must drop those collections before you can
+downgrade to an earlier MongoDB version.
diff --git a/source/includes/downgrade-introduction.rst b/source/includes/downgrade-introduction.rst
@@ -0,0 +1,5 @@
+The following sections provide information for removing
+backward-incompatible features from your deployment. If you are
+downgrading from MongoDB |version| to an earlier version, review the
+following sections to ensure that your deployment runs successfully
+after downgrading.
diff --git a/source/release-notes/5.3-compatibility.txt b/source/release-notes/5.3-compatibility.txt
@@ -47,3 +47,15 @@ Starting in MongoDB 5.3.0, 5.2.1, and 5.0.6, the :dbcommand:`dbStats`
 command and the :method:`db.stats()` method only report free space
 assigned to collections if the :ref:`freeStorage <dbStats-freeStorage>`
 parameter is set to 1.
+
+Downgrade Considerations
+------------------------
+
+.. |version| replace:: 5.3
+
+.. include:: /includes/downgrade-introduction.rst
+
+Clustered Collections
+~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/downgrade-for-clustered-collections.rst
diff --git a/source/release-notes/6.0-compatibility.txt b/source/release-notes/6.0-compatibility.txt
@@ -300,3 +300,15 @@ Starting in MongoDB 6.0, the :dbcommand:`dbStats` command and the
 :method:`db.stats()` method only report free space assigned to
 collections if the :ref:`freeStorage <dbStats-freeStorage>` parameter is
 set to 1.
+
+Downgrade Considerations
+------------------------
+
+.. |version| replace:: 6.0
+
+.. include:: /includes/downgrade-introduction.rst
+
+Clustered Collections
+~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/downgrade-for-clustered-collections.rst

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+Starting in MongoDB 5.3, if you are using :ref:`clustered collections
	`2`	+<clustered-collections>`, you must drop those collections before you can
	`3`	`+downgrade to an earlier MongoDB version.`