Skip to content

Commit f44c330

Browse files
authored
DOCSP-26700 Removes EOL version references from Replication - backport v4.2 (#2252)
* DOCSP-26700 Removes EOL version references from Replication (#2194) * Fixes build error
1 parent d3f799a commit f44c330

21 files changed

+83
-150
lines changed

source/core/replica-set-elections.txt

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -49,17 +49,12 @@ Factors and Conditions that Affect Elections
4949
Replication Election Protocol
5050
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5151

52-
.. versionchanged:: 4.0
53-
54-
MongoDB 4.0 removes the deprecated replication protocol version 0.
55-
5652
Replication :rsconf:`protocolVersion: 1 <protocolVersion>` reduces
5753
replica set failover time and accelerate the detection of multiple
5854
simultaneous primaries.
5955

60-
With protocolVersion 1, you can use
61-
:rsconf:`~settings.catchUpTimeoutMillis` to prioritize between faster
62-
failovers and preservation of :writeconcern:`w:1 <\<number\>>` writes.
56+
You can use :rsconf:`~settings.catchUpTimeoutMillis` to prioritize between
57+
faster failovers and preservation of :writeconcern:`w:1 <\<number\>>` writes.
6358

6459
For more information on ``pv1``, see
6560
:doc:`/reference/replica-set-protocol-versions`.

source/core/replica-set-oplog.txt

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,9 @@ The :term:`oplog` (operations log) is a special :term:`capped
1616
collection` that keeps a rolling record of all operations that modify
1717
the data stored in your databases.
1818

19-
.. note::
20-
21-
Starting in MongoDB 4.0, unlike other capped collections, the oplog
22-
can grow past its configured size limit to avoid deleting the
23-
:data:`majority commit point <replSetGetStatus.optimes.lastCommittedOpTime>`.
19+
Unlike other capped collections, the oplog
20+
can grow past its configured size limit to avoid deleting the
21+
:data:`majority commit point <replSetGetStatus.optimes.lastCommittedOpTime>`.
2422

2523
MongoDB applies database operations
2624
on the :term:`primary` and then records the operations on the
@@ -172,8 +170,7 @@ information.
172170
Slow Oplog Application
173171
----------------------
174172

175-
Starting in version 4.2 (also available starting in version 4.0.6),
176-
secondary members of a replica set now log oplog entries that take
173+
Secondary members of a replica set log oplog entries that take
177174
longer than the slow operation threshold to apply. These messages are
178175
:option:`logged <mongod --logpath>` for the secondaries under the
179176
:data:`REPL` component with the text ``applied op: <oplog entry> took
@@ -214,11 +211,10 @@ Oplog Collection Behavior
214211

215212
You cannot :dbcommand:`drop` the ``local.oplog.rs`` collection from any
216213
replica set member if your MongoDB deployment uses the :ref:`WiredTiger
217-
Storage Engine <storage-wiredtiger>`. Starting in v4.2, you cannot drop
218-
the ``local.oplog.rs`` collection from a standalone MongoDB instance,
219-
and we recommend that you do not drop the collection from a standalone
220-
MongoDB v4.0 instance. The :ref:`mongod` requires the oplog for both
221-
:ref:`replication` and recovery of a node if the node goes down.
214+
Storage Engine <storage-wiredtiger>`. You cannot drop
215+
the ``local.oplog.rs`` collection from a standalone MongoDB instance.
216+
:binary:`~bin.mongod` requires the oplog for
217+
both :ref:`replication` and recovery of a node if the node goes down.
222218

223219
Starting in MongoDB 4.2.11, it is no longer possible to perform manual
224220
write operations to the :doc:`oplog </core/replica-set-oplog>` on a

source/core/replica-set-rollbacks.txt

Lines changed: 8 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -45,9 +45,8 @@ Collect Rollback Data
4545
Configure Rollback Data
4646
~~~~~~~~~~~~~~~~~~~~~~~
4747

48-
Starting in version 4.0, MongoDB adds the parameter
49-
:parameter:`createRollbackDataFiles` to control whether or not rollback
50-
files are created during rollbacks.
48+
The :parameter:`createRollbackDataFiles` parameter
49+
controls whether or not rollback files are created during rollbacks.
5150

5251
Rollback Data
5352
~~~~~~~~~~~~~
@@ -137,35 +136,19 @@ Index Builds
137136
Size Limitations
138137
~~~~~~~~~~~~~~~~
139138

140-
.. versionchanged:: 4.0
141-
142-
Starting in version 4.0, MongoDB has no limit on the amount of data
143-
that can be rolled back.
144-
145-
In previous versions, a :binary:`~bin.mongod` instance will not
146-
roll back more than 300 megabytes of data and requires manual
147-
intervention if more than 300 megabytes of data need to be rolled back.
139+
MongoDB does not limit the amount of data you can roll back.
148140

149141
.. _rollback-time-limit:
150142

151143
Rollback Elapsed Time Limitations
152144
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
153145

154-
Starting in version 4.0, the rollback time limit defaults to 24 hours
155-
and is configurable using the parameter
156-
:parameter:`rollbackTimeLimitSecs`:
157-
158-
- In MongoDB 4.2+ and 4.0.13+, the rollback time limit is calculated
159-
between the first operation after the common point and the last point
160-
in the oplog for the member to roll back.
161-
162-
- In MongoDB 4.0.0-4.0.12, the rollback time limit is calculated between the
163-
common point and the last point in the oplog for the member to roll
164-
back.
146+
The rollback time limit defaults to 24 hours and is configurable using
147+
the :parameter:`rollbackTimeLimitSecs` parameter.
165148

166-
In MongoDB 3.6 and earlier, the rollback time limit is not configurable.
167-
For these versions, rollback is limited by the amount of data, with a
168-
maximum of 300 megabytes.
149+
MongoDB measures elapsed time as the time between the first common
150+
operation in the oplogs to the last entry in the oplog of the member
151+
being rolled back.
169152

170153
.. seealso:: :doc:`/core/replica-set-high-availability` and
171154
:doc:`/core/replica-set-elections`.

source/core/replica-set-sync.txt

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -213,14 +213,13 @@ improve concurrency. MongoDB groups batches by document id (:ref:`WiredTiger
213213
operations using a different thread. MongoDB always applies write
214214
operations to a given document in their original write order.
215215

216-
.. versionchanged:: 4.0
217-
218-
Starting in MongoDB 4.0, read operations that
216+
Read operations that
219217
:ref:`target secondaries <replica-set-read-preference>` and are
220218
configured with a :ref:`read concern<read-concern>` level of
221-
:readconcern:`"local"` or :readconcern:`"majority"` will now read from
219+
:readconcern:`"local"` or :readconcern:`"majority"` read from
222220
a :ref:`WiredTiger<storage-wiredtiger>` snapshot of the data if the read
223221
takes place on a secondary where replication batches are being applied.
222+
224223
Reading from a snapshot guarantees a consistent view of the
225224
data, and allows the read to occur simultaneously with the ongoing
226225
replication without the need for a lock. As a result, secondary reads

source/core/transactions-in-applications.txt

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -423,12 +423,6 @@ clusters)*, clients :red:`must` use MongoDB drivers updated for MongoDB
423423

424424
.. include:: /includes/list-4.2-drivers.rst
425425

426-
*For transactions on MongoDB 4.0 replica sets*, clients require MongoDB
427-
drivers updated for MongoDB 4.0 or later.
428-
429-
.. include:: /includes/list-4.0-drivers.rst
430-
431-
432426
.. _transactions-retry:
433427

434428
Transaction Error Handling

source/includes/extracts-4.2-changes.yaml

Lines changed: 24 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -97,16 +97,30 @@ content: |
9797
ref: 4.2-changes-slow-oplog-log-message-footnote
9898
content: |
9999
100-
Starting in version 4.2 (also available starting in 4.0.6), secondary members of a replica set now
101-
:ref:`log oplog entries <slow-oplog>` that take longer than the slow
102-
operation threshold to apply. These slow oplog messages are logged
103-
for the secondaries in the :option:`diagnostic log <mongod
104-
--logpath>` under the :data:`REPL` component with the text ``applied
105-
op: <oplog entry> took <num>ms``. These slow oplog entries depend
106-
only on the slow operation threshold. They do not depend on the log
107-
levels (either at the system or component level), or the profiling
108-
level, or the slow operation sample rate. The profiler does not
109-
capture slow oplog entries.
100+
Starting in version 4.2, secondary
101+
members of a replica set now :ref:`log oplog entries
102+
<slow-oplog>` that take longer than the slow operation
103+
threshold to apply. These slow oplog messages:
104+
105+
- Are logged for the secondaries in the
106+
:option:`diagnostic log <mongod --logpath>`.
107+
108+
- Are logged under the :data:`REPL` component with the text
109+
``applied op: <oplog entry> took <num>ms``.
110+
111+
- Do not depend on the log levels (either at the system or component
112+
level)
113+
114+
- Do not depend on the profiling level.
115+
116+
- May be affected by :setting:`~operationProfiling.slowOpSampleRate`,
117+
depending on your MongoDB version:
118+
119+
In MongoDB 4.2, these slow oplog entries are not
120+
affected by the :setting:`~operationProfiling.slowOpSampleRate`.
121+
MongoDB logs all slow oplog entries regardless of the sample rate.
122+
123+
The profiler does not capture slow oplog entries.
110124
---
111125
ref: 4.2-changes-type-0
112126
content: |

source/includes/extracts-changestream.yaml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -182,9 +182,7 @@ content: |
182182
ref: changestream-disable-rc-majority
183183
content: |
184184
185-
Disabling :readconcern:`"majority"` read concern disables support
186-
for :doc:`/changeStreams` for MongoDB 4.0 and earlier. For MongoDB
187-
4.2+, disabling read concern ``"majority"`` has no effect on change
185+
Disabling :readconcern:`"majority"` read concern has no effect on change
188186
streams availability.
189187
---
190188
ref: changestream-rc-majority-4.2

source/includes/extracts-default-bind-ip-security.yaml

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,37 @@
11
ref: default-bind-ip-security-command-line
22
content: |
33
4-
Starting in MongoDB 3.6, :binary:`~bin.mongod` and :binary:`~bin.mongos`
4+
:binary:`~bin.mongod` and :binary:`~bin.mongos`
55
bind to localhost by default. If the members of your deployment are
66
run on different hosts or if you wish remote clients to connect to
7-
your instance, you must specify the ``--bind_ip`` option. For more
8-
information, see :ref:`3.6-bind_ip-compatibility`.
7+
your instance, you must specify the ``--bind_ip`` option.
98
109
---
1110
ref: default-bind-ip-security-config-file
1211
content: |
1312
14-
Starting in MongoDB 3.6, :binary:`~bin.mongod` and :binary:`~bin.mongos`
13+
:binary:`~bin.mongod` and :binary:`~bin.mongos`
1514
bind to localhost by default. If the members of your deployment are
1615
run on different hosts or if you wish remote clients to connect to
1716
your deployment, you must specify the :setting:`net.bindIp` setting.
18-
For more information, see :ref:`3.6-bind_ip-compatibility`.
1917
---
2018
ref: default-bind-ip-security
2119
content: |
2220
23-
Starting in MongoDB 3.6, :binary:`~bin.mongod` and :binary:`~bin.mongos`
21+
:binary:`~bin.mongod` and :binary:`~bin.mongos`
2422
bind to localhost by default. If the members of your deployment are
2523
run on different hosts or if you wish remote clients to connect to
2624
your deployment, you must specify ``--bind_ip`` or
27-
:setting:`net.bindIp`. For more information, see
28-
:ref:`3.6-bind_ip-compatibility`.
25+
:setting:`net.bindIp`.
2926
---
3027
ref: default-bind-ip-security-windows
3128
content: |
3229
33-
Starting in MongoDB 3.6, :binary:`~bin.mongod.exe` and
30+
:binary:`~bin.mongod.exe` and
3431
:binary:`~bin.mongos.exe` bind to localhost by default. If the members
3532
of your deployment are run on different hosts or if you wish remote
3633
clients to connect to your deployment, you must specify
37-
``--bind_ip`` or :setting:`net.bindIp`. For more information, see
38-
:ref:`3.6-bind_ip-compatibility`. For more information on the
34+
``--bind_ip`` or :setting:`net.bindIp`. For more information on the
3935
configuration file, see :doc:`configuration
4036
options</reference/configuration-options>`.
4137

source/includes/extracts-hybrid-index-fcv.yaml

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,6 @@ content: |
2424
:ref:`index builds <index-operations>` to finish before starting a
2525
rollback.
2626
27-
- For :ref:`feature compatibility version (fcv) <view-fcv>` ``"4.0"``,
28-
MongoDB waits for any in-progress background
29-
:ref:`index builds <index-operations>` to finish before starting a
30-
rollback.
31-
3227
For more information on the index build process, see
3328
:ref:`index-operations`.
3429
---
Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1 @@
1-
Starting in MongoDB 3.6, arbiters have priority ``0``. When you upgrade
2-
a replica set to MongoDB 3.6, if the existing configuration has an
3-
arbiter with priority ``1``, MongoDB 3.6 reconfigures the arbiter to
4-
have priority ``0``.
1+
Arbiters have priority ``0``.
Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,3 @@
1-
Starting with MongoDB 3.6, MongoDB binaries, :binary:`~bin.mongod` and
1+
MongoDB binaries, :binary:`~bin.mongod` and
22
:binary:`~bin.mongos`, bind to ``localhost`` by default.
3-
From MongoDB versions 2.6 to 3.4, only the binaries from the
4-
official MongoDB RPM (Red Hat, CentOS, Fedora Linux, and derivatives)
5-
and DEB (Debian, Ubuntu, and derivatives) packages would bind to
6-
``localhost`` by default. To learn more about this change, see
7-
:ref:`3.6-bind_ip-compatibility`.
3+

source/includes/fact-oplog-size.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
Starting in MongoDB 4.0, the oplog can grow past its configured size
1+
The oplog can grow past its configured size
22
limit to avoid deleting the :data:`majority commit point
33
<replSetGetStatus.optimes.lastCommittedOpTime>`.

source/includes/fact-retryable-writes-failover-election.rst

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,5 @@ can detect the loss of the primary and automatically
44
:ref:`retry certain write operations <retryable-writes>` a single time,
55
providing additional built-in handling of automatic failovers and elections:
66

7-
.. versionchanged:: 4.2
8-
9-
Starting in MongoDB 4.2, compatible drivers enable retryable writes by default
7+
Compatible drivers enable retryable writes by default
108

source/includes/steps-change-replica-set-wiredtiger.yaml

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,9 @@ content: |
5555
5656
.. important::
5757
58-
If you are running a three-member PSA architecture and
59-
MongoDB version 4.0.3+, include
60-
:option:`--enableMajorityReadConcern false <mongod
61-
--enableMajorityReadConcern>` to disable read concern ``majority``. |seemore|
58+
If you are running a three-member PSA architecture, include
59+
:option:`--enableMajorityReadConcern false <mongod --enableMajorityReadConcern>`
60+
to disable read concern ``majority``. |seemore|
6261
6362
.. code-block:: sh
6463

source/tutorial/adjust-replica-set-member-priority.txt

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -42,17 +42,7 @@ of ``0``. :ref:`Hidden members <replica-set-hidden-members>` and
4242
:ref:`delayed members <replica-set-delayed-members>` have
4343
``priority`` set to ``0``.
4444

45-
46-
.. versionchanged:: 3.2
47-
48-
- .. include:: /includes/fact-rs-non-voting-priority-restriction.rst
49-
50-
- .. include:: /includes/fact-rs-nonzero-priority-vote-restriction.rst
51-
52-
.. versionchanged:: 3.6
53-
54-
.. include:: /includes/fact-arbiter-priority.rst
55-
45+
.. include:: /includes/fact-arbiter-priority.rst
5646

5747
Adjust priority settings during a scheduled maintenance window.
5848
Reconfiguring priority can force the current primary to step down,

source/tutorial/change-replica-set-wiredtiger.txt

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -29,20 +29,18 @@ rolling fashion.
2929
PSA 3-member Architecture
3030
~~~~~~~~~~~~~~~~~~~~~~~~~
3131

32-
Starting in MongoDB 3.6, :readconcern:`"majority"` read concern,
33-
available for WiredTiger, is enabled by default. However, for MongoDB
34-
4.0.3+, if you have a three-member replica set with a
35-
primary-secondary-arbiter (PSA) architecture, you can disable
36-
:readconcern:`"majority"` read concern. Disabling
37-
:readconcern:`"majority"` for a three member PSA architecture avoids
38-
possible cache-pressure build up.
39-
40-
The procedure below disables :readconcern:`"majority"` read concern for
41-
MongoDB 4.0.3 PSA architecture by including
32+
The :readconcern:`"majority"` read concern, available for WiredTiger,
33+
is enabled by default. However, in three-member replica sets with a
34+
primary-secondary-arbiter (PSA) architecture, you can disable the
35+
:readconcern:`"majority"` read concern.
36+
Disabling the :readconcern:`"majority"` read concern for a three-member
37+
PSA architecture avoids possible cache-pressure build up.
38+
39+
The :ref:`procedure <change-replica-set-wiredtiger-procedure>`
40+
below disables :readconcern:`"majority"` read concern for
41+
PSA architecture by including
4242
:option:`--enableMajorityReadConcern false <mongod
43-
--enableMajorityReadConcern>`. If you are running a MongoDB 4.0.1 or
44-
4.0.2 PSA architecture, first upgrade to the latest 4.0 version in
45-
order to disable this read concern.
43+
--enableMajorityReadConcern>`.
4644

4745
.. note::
4846

@@ -51,13 +49,6 @@ order to disable this read concern.
5149
For more information on PSA architecture and read concern
5250
:readconcern:`"majority"`, see :ref:`disable-read-concern-majority`.
5351

54-
MongoDB 3.0 or Greater
55-
~~~~~~~~~~~~~~~~~~~~~~
56-
57-
.. container:: admonition
58-
59-
.. include:: /includes/fact-wiredtiger-minimum-version.rst
60-
6152
Default Bind to Localhost
6253
~~~~~~~~~~~~~~~~~~~~~~~~~
6354

@@ -77,6 +68,8 @@ MMAPv1 Only Restrictions
7768

7869
.. include:: /includes/fact-mmapv1-only-restrictions.rst
7970

71+
.. _change-replica-set-wiredtiger-procedure:
72+
8073
Procedure
8174
---------
8275

source/tutorial/deploy-replica-set-with-keyfile-access-control.txt

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,6 @@ Considerations
4949
IP Binding
5050
~~~~~~~~~~~
5151

52-
.. versionchanged:: 3.6
53-
5452
.. include:: /includes/extracts/default-bind-ip-security.rst
5553

5654
Operating System

0 commit comments

Comments
 (0)