diff --git a/source/reference/parameters.txt b/source/reference/parameters.txt index fe67deaf74f..e569b5ea2a3 100644 --- a/source/reference/parameters.txt +++ b/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 diff --git a/source/reference/replica-configuration.txt b/source/reference/replica-configuration.txt index ac3af0c64fd..a6e4bd705e5 100644 --- a/source/reference/replica-configuration.txt +++ b/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:: diff --git a/source/release-notes/5.0.txt b/source/release-notes/5.0.txt index 4fbae55e2b3..c865665ec73 100644 --- a/source/release-notes/5.0.txt +++ b/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