DOCSP-17736 cluster chaining parameter

Author: jason-price-mongodb

source/reference/parameters.txt

@@ -1984,6 +1984,33 @@ The following parameters support diagnostic data capture (FTDC):
 Replication and Consistency
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. parameter:: enableOverrideClusterChainingSetting
+
+   .. versionadded:: 5.0.2
+
+   |both|
+
+   *Type*: boolean
+
+   *Default*: false
+   
+   If :parameter:`enableOverrideClusterChainingSetting` is ``true``,
+   replica set :term:`secondary` members can replicate data from
+   other secondary members even if :rsconf:`settings.chainingAllowed` is
+   ``false``.
+
+   You can only set :parameter:`enableOverrideClusterChainingSetting` at
+   startup and cannot change this setting with the
+   :dbcommand:`setParameter` command.
+
+   For example, to set the
+   :parameter:`enableOverrideClusterChainingSetting` for a
+   :binary:`~bin.mongod` instance to ``true``:
+
+   .. code-block:: bash
+
+      mongod --setParameter enableOverrideClusterChainingSetting=true
+
 .. parameter:: logicalSessionRefreshMillis
 
    .. note:: Availability

source/reference/replica-configuration.txt

@@ -467,11 +467,27 @@ Replica Set Configuration Fields
 
       *Default*: true
 
-      When :rsconf:`settings.chainingAllowed` is
-      ``true``, the replica set allows :term:`secondary` members to
-      replicate from other secondary members. When
-      :rsconf:`settings.chainingAllowed` is
-      ``false``, secondaries can replicate only from the :term:`primary`.
+      In MongoDB 5.0.1 and earlier, if
+      :rsconf:`settings.chainingAllowed` is:
+      
+      - ``true``, replica set :term:`secondary` members can
+        replicate data from other secondary members.
+      
+      - ``false``, secondary members can replicate data only from the
+        :term:`primary`.
+
+      Starting in MongoDB 5.0.2:
+      
+      - Replica set :term:`secondary` members can
+        replicate data from other secondary members even if
+        :rsconf:`settings.chainingAllowed` is ``false``.
+      
+      - To override :rsconf:`settings.chainingAllowed`, set the
+        :parameter:`enableOverrideClusterChainingSetting` server
+        parameter to ``true``.
+
+      - The default for
+        :parameter:`enableOverrideClusterChainingSetting` is ``false``.
 
       .. seealso::
 

source/release-notes/5.0.txt

@@ -455,6 +455,15 @@ re-evaluating a sync source. This parameter will not prevent a node
 from starting to sync from another node if it doesn't have a sync
 source.
 
+``enableOverrideClusterChainingSetting`` Server Parameter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 5.0.2, you can set the new
+:parameter:`enableOverrideClusterChainingSetting` server parameter to
+``true`` to allow :term:`secondary` members to replicate data from other
+secondary members even if :rsconf:`settings.chainingAllowed` is
+``false``.
+
 .. _5.0-rel-notes-security:
 
 Security
@@ -588,7 +597,6 @@ This parameter can affect the behavior of:
   :dbcommand:`moveChunk` commands to evenly distribute chunks across
   shards. See :ref:`sharding-balancing`.
 
-
 .. _5.0-rel-notes-shell:
 
 Shell Changes