DOCS-15477 coll mod rolling upgrade (BACKPORT) (#1642)

jason-price-mongodb · jason-price-mongodb · web-flow · commit fbb52a56a647 · 2022-08-15T13:05:41.000-07:00
* DOCS-15477 coll mod rolling upgrade (#1576) * DOCS-15477-collMod-rolling-upgrade * DOCS-15477-collMod-rolling-upgrade * DOCS-15477-collMod-rolling-upgrade * DOCS-15477-collMod-rolling-upgrade * DOCS-15477-collMod-rolling-upgrade * DOCS-15477-collMod-rolling-upgrade * DOCS-15477-collMod-rolling-upgrade Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> * DOCS-15477 coll mod rolling upgrade * DOCS-15477 coll mod rolling upgrade * DOCS-15477 coll mod rolling upgrade Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
diff --git a/source/includes/collMod-note.rst b/source/includes/collMod-note.rst
@@ -0,0 +1,4 @@
+The ``noPadding`` and ``usePowerOf2Sizes`` MMAPv1 options for the
+:dbcommand:`collMod` command are removed. Do not use those options
+because upgrading from MongoDB 4.0 to 4.2 causes the 4.2 :ref:`secondary
+members <replica-set-secondary-members>` to immediately halt.
diff --git a/source/reference/command/collMod.txt b/source/reference/command/collMod.txt
@@ -29,10 +29,7 @@ Definition
 
    .. note:: Starting in MongoDB 4.2
 
-
-      - MongoDB removes the MMAPv1 storage engine and the MMAPv1
-        specific options ``noPadding`` and ``usePowerOf2Sizes`` for
-        :dbcommand:`collMod`.
+      - .. include:: /includes/collMod-note.rst
 
       - .. include:: /includes/extracts/views-restriction-output-to-disk.rst
 
diff --git a/source/release-notes/4.2-upgrade-replica-set.txt b/source/release-notes/4.2-upgrade-replica-set.txt
@@ -16,6 +16,10 @@ Upgrade a Replica Set to 4.2
 
 .. include:: /includes/upgrade-copy.rst
 
+.. note:: Starting in MongoDB 4.2
+
+   .. include:: /includes/collMod-note.rst
+
 .. |downgrading| replace:: :doc:`downgrading </release-notes/4.2-downgrade-replica-set>`
 
 Read Concern Majority (3-Member Primary-Secondary-Arbiter Architecture)
diff --git a/source/tutorial/change-replica-set-wiredtiger.txt b/source/tutorial/change-replica-set-wiredtiger.txt
@@ -5,11 +5,13 @@ Change Replica Set to WiredTiger
 .. default-domain:: mongodb
 
 
-.. note::
+.. note:: Starting in MongoDB 4.2
+
+   - .. include:: /includes/collMod-note.rst
 
-   Starting in version 4.2, MongoDB removes the deprecated MMAPv1
-   storage engine. If upgrading to MongoDB 4.2 from a MongoDB 4.0
-   deployment that uses MMAPv1, you must upgrade to WiredTiger.
+   - MongoDB removes the deprecated MMAPv1 storage engine. If you're
+     upgrading to MongoDB 4.2 from a MongoDB 4.0 deployment that uses
+     MMAPv1, you must upgrade to WiredTiger.
 
 Use this tutorial to update a replica set to use :ref:`WiredTiger
 <storage-wiredtiger>`. The procedure updates the replica set in a
