DOCS-14135 enableMajorityReadConcern may only be set to true in v5.0

jmd-mongo · andf-mongodb · commit c841190a5ab2 · 2021-07-13T14:56:38.000-04:00
diff --git a/source/core/replica-set-arbiter.txt b/source/core/replica-set-arbiter.txt
@@ -48,24 +48,6 @@ number of votes to break a tie:
 
 .. end-content-even-votes-example
 
-Read Concern ``majority`` and Three-Member PSA
-----------------------------------------------
-
-.. warning:: For 3-Member Primary-Secondary-Arbiter Architecture*
-
-
-   If you have a three-member replica set with a
-   primary-secondary-arbiter (PSA) architecture or a sharded cluster
-   with a three-member PSA shards, the cache pressure will increase if
-   any data bearing node is down and support for
-   :readconcern:`"majority"` read concern is enabled. 
-
-   To prevent the storage cache pressure from immobilizing a deployment
-   with a three-member primary-secondary-arbiter (PSA) architecture,
-   you can disable read concern "majority" starting in MongoDB 4.0.3
-   (and 3.6.1+). For more information, see
-   :ref:`disable-read-concern-majority`.
-
 Replica Set Protocol Version and Arbiter
 -----------------------------------------
 
diff --git a/source/core/transactions-production-consideration.txt b/source/core/transactions-production-consideration.txt
@@ -147,37 +147,6 @@ Sharded Clusters and Arbiters
 
 .. include:: /includes/extracts/transactions-arbiters.rst
 
-.. |disabledrcmaj| replace:: :ref:`transactions-psa`
-
-.. _transactions-psa:
-
-3-Member Primary-Secondary-Arbiter Architecture
------------------------------------------------
-  
-For a three-member replica set with a primary-secondary-arbiter (PSA)
-architecture or a sharded cluster with a three-member PSA shards, you
-may have :ref:`disabled read concern "majority"
-<disable-read-concern-majority>` to avoid cache pressure.
-
-.. include:: /includes/extracts/transactions-read-concern-majority-sharded-clusters.rst
-
-.. include:: /includes/extracts/transactions-read-concern-majority-replica-set.rst
-
-.. tip::
-
-   To check if read concern "majority" is disabled, You can run
-   :method:`db.serverStatus()` on the :binary:`~bin.mongod` instances
-   and check the :serverstatus:`storageEngine.supportsCommittedReads`
-   field. If ``false``, read concern "majority" is disabled.
-
-.. seealso::
-
-   - :option:`--enableMajorityReadConcern false <mongod
-     --enableMajorityReadConcern>`
-
-   - :setting:`replication.enableMajorityReadConcern: false
-     <replication.enableMajorityReadConcern>`.
-  
 .. _txns-locks:
 
 Acquiring Locks
diff --git a/source/core/transactions-sharded-clusters.txt b/source/core/transactions-sharded-clusters.txt
@@ -113,27 +113,6 @@ Arbiters
 
 .. include:: /includes/extracts/transactions-arbiters.rst
 
-.. |disabledrcmaj| replace:: :ref:`transactions-sharded-clusters-psa`
-
-.. _transactions-sharded-clusters-psa:
-
-Three Member Primary-Secondary-Arbiter Shards
----------------------------------------------
-
-For a sharded cluster with three-member PSA shards, you may have
-:ref:`disabled read concern "majority" <disable-read-concern-majority>`
-(i.e. :option:`--enableMajorityReadConcern false <mongod
---enableMajorityReadConcern>` or
-:setting:`replication.enableMajorityReadConcern: false
-<replication.enableMajorityReadConcern>`) to avoid cache pressure.
-
-.. include:: /includes/extracts/transactions-read-concern-majority-sharded-clusters.rst
-
-To check if read concern "majority" is disabled, 
-   You can run :method:`db.serverStatus()` and check the
-   :serverstatus:`storageEngine.supportsCommittedReads` field. If
-   ``false``, read concern "majority" is disabled.
-
 Backups and Restores
 --------------------
 
diff --git a/source/core/transactions.txt b/source/core/transactions.txt
@@ -714,34 +714,6 @@ Arbiters
 
 .. include:: /includes/extracts/transactions-arbiters.rst
 
-.. |disabledrcmaj| replace:: :ref:`transactions-disabled-rc-majority`
-
-.. _transactions-disabled-rc-majority:
-
-Disabled Read Concern Majority
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-A 3-member PSA (Primary-Secondary-Arbiter) replica set or a sharded
-cluster with 3-member PSA shards may have disabled read concern
-majority (:option:`--enableMajorityReadConcern false <mongod
---enableMajorityReadConcern>` or
-:setting:`replication.enableMajorityReadConcern: false
-<replication.enableMajorityReadConcern>`)
-
-.. include:: /includes/extracts/transactions-read-concern-majority-sharded-clusters.rst
-
-.. include:: /includes/extracts/transactions-read-concern-majority-replica-set.rst
-
-.. tip::
-
-   To check if read concern "majority" is disabled, You can run
-   :method:`db.serverStatus()` on the :binary:`~bin.mongod` instances
-   and check the :serverstatus:`storageEngine.supportsCommittedReads`
-   field. If ``false``, read concern "majority" is disabled.
- 
-For more information, see :ref:`transactions-psa` and
-:ref:`transactions-sharded-clusters-psa`.
-
 .. _transactions-wcmajority-disabled:
 
 Shard Configuration Restriction
diff --git a/source/includes/extracts-transactions.yaml b/source/includes/extracts-transactions.yaml
@@ -294,29 +294,6 @@ content: |
 # This is included in pages talking more about disabling rc majority and its effects.
 
 # Separate includes (see below) for transactions pages where the transactions leads as the subject
----
-ref: transactions-read-concern-majority-sharded-clusters
-content: |
-
-   On sharded clusters, 
-      - If a transaction involves a shard that has :ref:`disabled read
-        concern "majority" <disable-read-concern-majority>`, you cannot
-        use read concern :readconcern:`"snapshot"` for the transaction.
-        You can only use read concern :readconcern:`"local"` or
-        :readconcern:`"majority"` for the transaction. If you use read
-        concern :readconcern:`"snapshot"`, the transaction errors and
-        aborts.
-
-        .. code-block:: none
-           :copyable: false
-
-           readConcern level 'snapshot' is not supported in sharded clusters when enableMajorityReadConcern=false.
-
-      - Transactions whose write operations span multiple shards will
-        error and abort if any of the transaction's read or write
-        operations involves a shard that has disabled read concern
-        ``"majority"``.
-
 ---
 ref: transactions-read-concern-majority-replica-set
 content: |  
@@ -459,8 +436,6 @@ content: |
    and abort if any transaction operation reads from or writes to a
    shard that contains an arbiter.
 
-   See also |disabledrcmaj| for transaction restrictions on shards that
-   have disabled read concern majority.
 ---
 ref: transactions-committed-visibility
 content: |
diff --git a/source/includes/fact-eMRC-always-true-in-5.0.rst b/source/includes/fact-eMRC-always-true-in-5.0.rst
@@ -0,0 +1,11 @@
+Starting in MongoDB 5.0,
+:setting:`~replication.enableMajorityReadConcern` and 
+:option:`--enableMajorityReadConcern` cannot be changed 
+and are always set to ``true`` due to storage engine improvements. 
+
+In earlier versions of MongoDB, 
+:setting:`~replication.enableMajorityReadConcern` and 
+:option:`--enableMajorityReadConcern` are configurable and can be set 
+to ``false`` to prevent storage cache pressure from immobilizing a 
+deployment with a three-member primary-secondary-arbiter (PSA) 
+architecture.
diff --git a/source/includes/fact-enable-majority-readConcern.rst b/source/includes/fact-enable-majority-readConcern.rst
diff --git a/source/reference/command/aggregate.txt b/source/reference/command/aggregate.txt
@@ -546,8 +546,6 @@ majority of the nodes.
 
 .. important::
 
-   - .. include:: /includes/fact-enable-majority-readConcern.rst
-
    - .. include:: /includes/fact-aggregate-readConcern.rst
 
    - .. include:: /includes/fact-readConcern-most-recent-data-in-node.rst
diff --git a/source/reference/command/count.txt b/source/reference/command/count.txt
@@ -302,8 +302,6 @@ majority of the nodes.
 
 .. important::
 
-   - .. include:: /includes/fact-enable-majority-readConcern.rst
-
    - To use the ``readConcern`` level of ``"majority"``, you must specify
      a nonempty ``query`` condition.
 
diff --git a/source/reference/command/distinct.txt b/source/reference/command/distinct.txt
@@ -298,9 +298,7 @@ majority of the nodes.
 
 .. note::
 
-   - .. include:: /includes/fact-enable-majority-readConcern.rst
-
-   - .. include:: /includes/fact-readConcern-most-recent-data-in-node.rst
+   .. include:: /includes/fact-readConcern-most-recent-data-in-node.rst
 
 .. code-block:: javascript
 
diff --git a/source/reference/command/find.txt b/source/reference/command/find.txt
@@ -583,8 +583,6 @@ The following operation on a replica set specifies a :term:`read
 concern` of :readconcern:`"majority"` to read the most recent copy of
 the data confirmed as having been written to a majority of the nodes.
 
-.. include:: /includes/fact-enable-majority-readConcern.rst
-
 .. code-block:: javascript
 
    db.runCommand(
diff --git a/source/reference/command/geoSearch.txt b/source/reference/command/geoSearch.txt
@@ -154,9 +154,7 @@ majority of the nodes.
 
 .. note::
 
-   - .. include:: /includes/fact-enable-majority-readConcern.rst
-
-   - .. include:: /includes/fact-readConcern-most-recent-data-in-node.rst
+   .. include:: /includes/fact-readConcern-most-recent-data-in-node.rst
 
 .. code-block:: javascript
 
diff --git a/source/reference/configuration-options.txt b/source/reference/configuration-options.txt
@@ -4138,32 +4138,12 @@ LDAP Parameters
 
    *Default*: true
 
-   
-   Starting in MongoDB 3.6, MongoDB enables support for
-   :readconcern:`"majority"` read concern by default.
-   
-   You can disable read concern :readconcern:`"majority"` to prevent
-   the storage cache pressure from immobilizing a deployment with a
-   three-member primary-secondary-arbiter (PSA) architecture. For more
-   information about disabling read concern :readconcern:`"majority"`,
-   see :ref:`disable-read-concern-majority`.
-   
-   To disable, set :setting:`replication.enableMajorityReadConcern` to false. :setting:`replication.enableMajorityReadConcern` has no effect for
-   MongoDB versions: 4.0.0, 4.0.1, 4.0.2, 3.6.0.
-   
-   .. important::
-   
-      In general, avoid disabling :readconcern:`"majority"` read concern
-      unless necessary. However, if you have a three-member replica set
-      with a primary-secondary-arbiter (PSA) architecture or a sharded
-      cluster with a three-member PSA shards, disable to prevent the
-      storage cache pressure from immobilizing the deployment.
-   
-      .. include:: /includes/extracts/transactions-read-concern-majority.rst
-
-      .. include:: /includes/fact-disable-majority-rc-rollbacks.rst
-   
-      .. include:: /includes/extracts/changestream-disable-rc-majority.rst
+   Configures support for :readconcern:`"majority"` read concern.
+ 
+   Starting in MongoDB 5.0, 
+   :setting:`~replication.enableMajorityReadConcern` cannot be changed 
+   and is always set to ``true``. In earlier versions of MongoDB, 
+   :setting:`~replication.enableMajorityReadConcern` was configurable.
 
 
 ``sharding`` Options
diff --git a/source/reference/method/cursor.readConcern.txt b/source/reference/method/cursor.readConcern.txt
@@ -60,11 +60,6 @@ Definition
 Considerations
 --------------
 
-``"majority"`` Read Concern
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. include:: /includes/fact-enable-majority-readConcern.rst
-
 Read Your Own Writes
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/source/reference/method/db.collection.aggregate.txt b/source/reference/method/db.collection.aggregate.txt
@@ -552,8 +552,6 @@ majority of the nodes.
 
 .. note::
 
-   - .. include:: /includes/fact-enable-majority-readConcern.rst
-
    - .. include:: /includes/usage-read-concern-majority.rst
 
    - .. include:: /includes/fact-aggregate-readConcern.rst
diff --git a/source/reference/method/db.collection.count.txt b/source/reference/method/db.collection.count.txt
@@ -132,8 +132,6 @@ Definition
         - Optional. Specifies the :term:`read concern`. The default level is
           :readconcern:`"local"`.
           
-          .. include:: /includes/fact-enable-majority-readConcern.rst
-          
           .. include:: /includes/usage-read-concern-majority.rst
           
           .. include:: /includes/fact-count-readConcern.rst
diff --git a/source/reference/program/mongod.txt b/source/reference/program/mongod.txt
@@ -1836,33 +1836,12 @@ Replication Options
 
    *Default*: true
 
-   
-   Starting in MongoDB 3.6, MongoDB enables support for
-   :readconcern:`"majority"` read concern by default.
-   
-   You can disable read concern :readconcern:`"majority"` to prevent
-   the storage cache pressure from immobilizing a deployment with a
-   three-member primary-secondary-arbiter (PSA) architecture. For more
-   information about disabling read concern :readconcern:`"majority"`,
-   see :ref:`disable-read-concern-majority`.
-   
-   To disable, set :option:`--enableMajorityReadConcern` to false. :option:`--enableMajorityReadConcern` has no effect for
-   MongoDB versions: 4.0.0, 4.0.1, 4.0.2, 3.6.0.
-   
-   .. important::
-   
-      In general, avoid disabling :readconcern:`"majority"` read concern
-      unless necessary. However, if you have a three-member replica set
-      with a primary-secondary-arbiter (PSA) architecture or a sharded
-      cluster with a three-member PSA shards, disable to prevent the
-      storage cache pressure from immobilizing the deployment.
-   
-      .. include:: /includes/extracts/transactions-read-concern-majority.rst
-
-      .. include:: /includes/fact-disable-majority-rc-rollbacks.rst
-   
-      .. include:: /includes/extracts/changestream-disable-rc-majority.rst
-
+   Configures support for :readconcern:`"majority"` read concern.
+ 
+   Starting in MongoDB 5.0, 
+   :option:`--enableMajorityReadConcern` cannot be changed 
+   and is always set to ``true``. In earlier versions of MongoDB, 
+   :option:`--enableMajorityReadConcern` was configurable.
 
 Sharded Cluster Options
 ~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/source/reference/read-concern-majority.txt b/source/reference/read-concern-majority.txt
diff --git a/source/reference/read-concern-snapshot.txt b/source/reference/read-concern-snapshot.txt
diff --git a/source/reference/read-concern.txt b/source/reference/read-concern.txt
diff --git a/source/release-notes/5.0-compatibility.txt b/source/release-notes/5.0-compatibility.txt
diff --git a/source/release-notes/5.0.txt b/source/release-notes/5.0.txt
diff --git a/source/tutorial/add-replica-set-arbiter.txt b/source/tutorial/add-replica-set-arbiter.txt
diff --git a/source/tutorial/upgrade-revision.txt b/source/tutorial/upgrade-revision.txt
