From a622d50f867405bee60e90d93eb03f1f3f3e296f Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Tue, 7 Jul 2020 13:30:02 -0400 Subject: [PATCH] (DOCS-13722): collMod entries which modify an index cannot be be rolled back --- source/core/replica-set-rollbacks.txt | 5 +++++ source/includes/fact-disable-majority-rc-rollbacks.rst | 5 +++++ source/reference/configuration-options.txt | 2 ++ source/reference/program/mongod.txt | 4 ++-- source/reference/read-concern-majority.txt | 4 ++++ source/release-notes/4.2-upgrade-replica-set.txt | 2 ++ source/release-notes/4.2-upgrade-sharded-cluster.txt | 2 ++ source/tutorial/change-sharded-cluster-wiredtiger.txt | 2 ++ source/tutorial/upgrade-revision.txt | 2 ++ 9 files changed, 26 insertions(+), 2 deletions(-) create mode 100644 source/includes/fact-disable-majority-rc-rollbacks.rst diff --git a/source/core/replica-set-rollbacks.txt b/source/core/replica-set-rollbacks.txt index 5312182d169..e599cc14912 100644 --- a/source/core/replica-set-rollbacks.txt +++ b/source/core/replica-set-rollbacks.txt @@ -223,6 +223,11 @@ Index Builds .. include:: /includes/extracts/4.2-rollbacks.rst +Index Operations When :readconcern:`"majority"` Read Concern is Disabled +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. include:: /includes/fact-disable-majority-rc-rollbacks.rst + Size Limitations ~~~~~~~~~~~~~~~~ diff --git a/source/includes/fact-disable-majority-rc-rollbacks.rst b/source/includes/fact-disable-majority-rc-rollbacks.rst new file mode 100644 index 00000000000..4a81eb319db --- /dev/null +++ b/source/includes/fact-disable-majority-rc-rollbacks.rst @@ -0,0 +1,5 @@ +Disabling :readconcern:`"majority"` read concern prevents +:dbcommand:`collMod` commands which modify an index from +:ref:`rolling back `. If such an operation needs +to be rolled back, you must resync the affected nodes with the +:term:`primary` node. diff --git a/source/reference/configuration-options.txt b/source/reference/configuration-options.txt index b01faa178f8..ab68ff9bb3b 100644 --- a/source/reference/configuration-options.txt +++ b/source/reference/configuration-options.txt @@ -4101,6 +4101,8 @@ LDAP Parameters 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 diff --git a/source/reference/program/mongod.txt b/source/reference/program/mongod.txt index 68138cf8432..9d474ed31ba 100644 --- a/source/reference/program/mongod.txt +++ b/source/reference/program/mongod.txt @@ -1844,6 +1844,8 @@ Replication Options 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 @@ -3354,5 +3356,3 @@ Encryption Key Management Options instance rotates the keys and exits. .. include:: /includes/fact-enterprise-only-admonition.rst - - diff --git a/source/reference/read-concern-majority.txt b/source/reference/read-concern-majority.txt index c8398591a50..1e06d2c198a 100644 --- a/source/reference/read-concern-majority.txt +++ b/source/reference/read-concern-majority.txt @@ -186,3 +186,7 @@ If ``false``, read concern "majority" is disabled. .. topic:: Transactions .. include:: /includes/extracts/transactions-read-concern-majority.rst + +.. topic:: Rollback Considerations + + .. include:: /includes/fact-disable-majority-rc-rollbacks.rst diff --git a/source/release-notes/4.2-upgrade-replica-set.txt b/source/release-notes/4.2-upgrade-replica-set.txt index d05110e2f82..404b25373b1 100644 --- a/source/release-notes/4.2-upgrade-replica-set.txt +++ b/source/release-notes/4.2-upgrade-replica-set.txt @@ -33,6 +33,8 @@ cluster with a three-member PSA shards. .. include:: /includes/extracts/transactions-read-concern-majority.rst + .. include:: /includes/fact-disable-majority-rc-rollbacks.rst + .. include:: /includes/extracts/changestream-disable-rc-majority.rst When upgraded to 4.2 with read concern "majority" disabled, you can diff --git a/source/release-notes/4.2-upgrade-sharded-cluster.txt b/source/release-notes/4.2-upgrade-sharded-cluster.txt index 8ccd39fdbee..57b31908204 100644 --- a/source/release-notes/4.2-upgrade-sharded-cluster.txt +++ b/source/release-notes/4.2-upgrade-sharded-cluster.txt @@ -32,6 +32,8 @@ cluster with a three-member PSA shards. .. include:: /includes/extracts/transactions-read-concern-majority.rst + .. include:: /includes/fact-disable-majority-rc-rollbacks.rst + .. include:: /includes/extracts/changestream-disable-rc-majority.rst When upgraded to 4.2 with read concern "majority" disabled, you can diff --git a/source/tutorial/change-sharded-cluster-wiredtiger.txt b/source/tutorial/change-sharded-cluster-wiredtiger.txt index ae9f4ff6ac9..5f15b82a7ef 100644 --- a/source/tutorial/change-sharded-cluster-wiredtiger.txt +++ b/source/tutorial/change-sharded-cluster-wiredtiger.txt @@ -60,6 +60,8 @@ order to disable this read concern. .. include:: /includes/extracts/changestream-disable-rc-majority.rst + .. include:: /includes/fact-disable-majority-rc-rollbacks.rst + .. include:: /includes/extracts/transactions-read-concern-majority.rst For more information on PSA architecture and read concern diff --git a/source/tutorial/upgrade-revision.txt b/source/tutorial/upgrade-revision.txt index 642906a3459..a40cfa30537 100644 --- a/source/tutorial/upgrade-revision.txt +++ b/source/tutorial/upgrade-revision.txt @@ -82,6 +82,8 @@ primary-secondary-arbiter (PSA) architecture. However, - .. include:: /includes/extracts/changestream-disable-rc-majority.rst +- .. include:: /includes/fact-disable-majority-rc-rollbacks.rst + - .. include:: /includes/extracts/transactions-read-concern-majority.rst For more information, see :ref:`disable-read-concern-majority`.