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

jason-price-mongodb · jason-price-mongodb · web-flow · commit 736ce6f574b8 · 2022-05-03T12:46:16.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> 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

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.`