Skip to content

Commit 797d9ee

Browse files
jeff-allen-mongojason-price-mongodb
andauthored
DOCSP-17736 cluster chaining parameter (#1305)
Co-authored-by: jason-price-mongodb <[email protected]>
1 parent 737c58a commit 797d9ee

File tree

2 files changed

+48
-5
lines changed

2 files changed

+48
-5
lines changed

source/reference/parameters.txt

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1567,6 +1567,33 @@ The following parameters support diagnostic data capture (FTDC):
15671567
Logical Session Parameters
15681568
~~~~~~~~~~~~~~~~~~~~~~~~~~
15691569

1570+
.. parameter:: enableOverrideClusterChainingSetting
1571+
1572+
.. versionadded:: 4.2.16
1573+
1574+
|both|
1575+
1576+
*Type*: boolean
1577+
1578+
*Default*: false
1579+
1580+
If :parameter:`enableOverrideClusterChainingSetting` is ``true``,
1581+
replica set :term:`secondary` members can replicate data from
1582+
other secondary members even if :rsconf:`settings.chainingAllowed` is
1583+
``false``.
1584+
1585+
You can only set :parameter:`enableOverrideClusterChainingSetting` at
1586+
startup and cannot change this setting with the
1587+
:dbcommand:`setParameter` command.
1588+
1589+
For example, to set the
1590+
:parameter:`enableOverrideClusterChainingSetting` for a
1591+
:binary:`~bin.mongod` instance to ``true``:
1592+
1593+
.. code-block:: bash
1594+
1595+
mongod --setParameter enableOverrideClusterChainingSetting=true
1596+
15701597
.. parameter:: logicalSessionRefreshMillis
15711598

15721599
.. admonition:: Availability

source/reference/replica-configuration.txt

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -400,11 +400,27 @@ Replica Set Configuration Fields
400400

401401
*Default*: true
402402

403-
When :rsconf:`settings.chainingAllowed` is
404-
``true``, the replica set allows :term:`secondary` members to
405-
replicate from other secondary members. When
406-
:rsconf:`settings.chainingAllowed` is
407-
``false``, secondaries can replicate only from the :term:`primary`.
403+
In MongoDB 4.2.15 and earlier, if
404+
:rsconf:`settings.chainingAllowed` is:
405+
406+
- ``true``, replica set :term:`secondary` members can
407+
replicate data from other secondary members.
408+
409+
- ``false``, secondary members can replicate data only from the
410+
:term:`primary`.
411+
412+
Starting in MongoDB 4.2.16:
413+
414+
- Replica set :term:`secondary` members can
415+
replicate data from other secondary members even if
416+
:rsconf:`settings.chainingAllowed` is ``false``.
417+
418+
- To override :rsconf:`settings.chainingAllowed`, set the
419+
:parameter:`enableOverrideClusterChainingSetting` server
420+
parameter to ``true``.
421+
422+
- The default for
423+
:parameter:`enableOverrideClusterChainingSetting` is ``false``.
408424

409425
.. seealso:: :doc:`/tutorial/manage-chained-replication`
410426

0 commit comments

Comments
 (0)