Skip to content

Commit 52f0395

Browse files
authored
DOCSP-26700 Removes EOL version references from Replication (#2194) (#2244)
* DOCSP-26700 Removes EOL version references from Core Replication and Sharding pages * EOL cleanup * Fixes EOL mentions in includes * Fixes EOL mentions in includes * Fixes text * Fixes per Ashley * Fixes per Ashley * Fixes per Ashley * Fixes per Ashley * Fixes per Samy Lanka
1 parent 253ab15 commit 52f0395

22 files changed

+66
-152
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: 7 additions & 11 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-
.. versionchanged:: 4.0
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
.. versionadded:: 4.4
2624

@@ -217,8 +215,7 @@ information.
217215
Slow Oplog Application
218216
----------------------
219217

220-
Starting in version 4.2 (also available starting in version 4.0.6),
221-
secondary members of a replica set now log oplog entries that take
218+
Secondary members of a replica set log oplog entries that take
222219
longer than the slow operation threshold to apply. These messages are
223220
:option:`logged <mongod --logpath>` for the secondaries under the
224221
:data:`REPL` component with the text ``applied op: <oplog entry> took
@@ -256,10 +253,9 @@ Oplog Collection Behavior
256253

257254
You cannot :dbcommand:`drop` the ``local.oplog.rs`` collection from any
258255
replica set member if your MongoDB deployment uses the :ref:`WiredTiger
259-
Storage Engine <storage-wiredtiger>`. Starting in v4.2, you cannot drop
260-
the ``local.oplog.rs`` collection from a standalone MongoDB instance,
261-
and we recommend that you do not drop the collection from a standalone
262-
MongoDB v4.0 instance. The :binary:`~bin.mongod` requires the oplog for
256+
Storage Engine <storage-wiredtiger>`. You cannot drop
257+
the ``local.oplog.rs`` collection from a standalone MongoDB instance.
258+
:binary:`~bin.mongod` requires the oplog for
263259
both :ref:`replication` and recovery of a node if the node goes down.
264260

265261
Starting in MongoDB 5.0, it is no longer possible to perform manual

source/core/replica-set-rollbacks.txt

Lines changed: 9 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -41,9 +41,8 @@ Collect Rollback Data
4141
Configure Rollback Data
4242
~~~~~~~~~~~~~~~~~~~~~~~
4343

44-
Starting in version 4.0, MongoDB adds the parameter
45-
:parameter:`createRollbackDataFiles` to control whether or not rollback
46-
files are created during rollbacks.
44+
The :parameter:`createRollbackDataFiles` parameter
45+
controls whether or not rollback files are created during rollbacks.
4746

4847
.. _replica-set-rollback-data:
4948

@@ -115,7 +114,7 @@ By default, when a rollback occurs, MongoDB writes the rollback data to
115114
if (foundcollection) { break; }
116115
}
117116

118-
.. tab:: MongoDB 4.2-4.0
117+
.. tab:: MongoDB 4.2
119118
:tabid: 4.2
120119

121120
For each collection whose data is rolled back, the
@@ -137,20 +136,6 @@ By default, when a rollback occurs, MongoDB writes the rollback data to
137136

138137
where ``<dbpath>`` is the :binary:`~bin.mongod`'s :setting:`~storage.dbPath`.
139138

140-
.. tab:: MongoDB 3.6 and earlier
141-
:tabid: 3.6
142-
143-
In versions 3.6 and earlier, rollback files are located directly under the
144-
``<dbpath>/rollback`` directory with the filenames of the form
145-
``<db>.<collection>.<timestamp>.bson``.
146-
147-
For example, if data for the collection ``comments`` in the
148-
``reporting`` database rolled back:
149-
150-
.. code-block:: none
151-
:copyable: false
152-
153-
<dbpath>/rollbacktest.col.2020-02-19T04-46-22.0.bson
154139

155140
Rollback Data Exclusion
156141
~~~~~~~~~~~~~~~~~~~~~~~
@@ -220,35 +205,19 @@ Index Operations When :readconcern:`"majority"` Read Concern is Disabled
220205
Size Limitations
221206
~~~~~~~~~~~~~~~~
222207

223-
.. versionchanged:: 4.0
224-
225-
Starting in version 4.0, MongoDB has no limit on the amount of data
226-
that can be rolled back.
227-
228-
In previous versions, a :binary:`~bin.mongod` instance will not
229-
roll back more than 300 megabytes of data and requires manual
230-
intervention if more than 300 megabytes of data need to be rolled back.
208+
MongoDB does not limit the amount of data you can roll back.
231209

232210
.. _rollback-time-limit:
233211

234212
Rollback Elapsed Time Limitations
235213
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
236214

237-
Starting in version 4.0, the rollback time limit defaults to 24 hours
238-
and is configurable using the parameter
239-
:parameter:`rollbackTimeLimitSecs`:
240-
241-
- In MongoDB 4.2+ and 4.0.13+, the rollback time limit is calculated
242-
between the first operation after the common point and the last point
243-
in the oplog for the member to roll back.
244-
245-
- In MongoDB 4.0.0-4.0.12, the rollback time limit is calculated between the
246-
common point and the last point in the oplog for the member to roll
247-
back.
215+
The rollback time limit defaults to 24 hours and is configurable using
216+
the :parameter:`rollbackTimeLimitSecs` parameter.
248217

249-
In MongoDB 3.6 and earlier, the rollback time limit is not configurable.
250-
For these versions, rollback is limited by the amount of data, with a
251-
maximum of 300 megabytes.
218+
MongoDB measures elapsed time as the time between the first common
219+
operation in the oplogs to the last entry in the oplog of the member
220+
being rolled back.
252221

253222
.. seealso::
254223

source/core/replica-set-sync.txt

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

309-
.. versionchanged:: 4.0
310-
311-
Starting in MongoDB 4.0, read operations that
309+
Read operations that
312310
:ref:`target secondaries <replica-set-read-preference>` and are
313311
configured with a :ref:`read concern<read-concern>` level of
314-
:readconcern:`"local"` or :readconcern:`"majority"` will now read from
312+
:readconcern:`"local"` or :readconcern:`"majority"` read from
315313
a :ref:`WiredTiger<storage-wiredtiger>` snapshot of the data if the read
316314
takes place on a secondary where replication batches are being applied.
315+
317316
Reading from a snapshot guarantees a consistent view of the
318317
data, and allows the read to occur simultaneously with the ongoing
319318
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
@@ -362,12 +362,6 @@ clusters)*, clients :red:`must` use MongoDB drivers updated for MongoDB
362362

363363
.. include:: /includes/list-4.2-drivers.rst
364364

365-
*For transactions on MongoDB 4.0 replica sets*, clients require MongoDB
366-
drivers updated for MongoDB 4.0 or later.
367-
368-
.. include:: /includes/list-4.0-drivers.rst
369-
370-
371365
.. _transactions-retry:
372366

373367
Transaction Error Handling

source/includes/extracts-4.2-changes.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ 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
100+
Starting in version 4.2, secondary
101101
members of a replica set now :ref:`log oplog entries
102102
<slow-oplog-application>` that take longer than the slow operation
103103
threshold to apply. These slow oplog messages:
@@ -116,7 +116,7 @@ content: |
116116
- May be affected by :setting:`~operationProfiling.slowOpSampleRate`,
117117
depending on your MongoDB version:
118118
119-
- In MongoDB 4.2 and earlier, these slow oplog entries are not
119+
- In MongoDB 4.2, these slow oplog entries are not
120120
affected by the :setting:`~operationProfiling.slowOpSampleRate`.
121121
MongoDB logs all slow oplog entries regardless of the sample rate.
122122

source/includes/extracts-changestream.yaml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -181,9 +181,7 @@ content: |
181181
ref: changestream-disable-rc-majority
182182
content: |
183183
184-
Disabling :readconcern:`"majority"` read concern disables support
185-
for :doc:`/changeStreams` for MongoDB 4.0 and earlier. For MongoDB
186-
4.2+, disabling read concern ``"majority"`` has no effect on change
184+
Disabling :readconcern:`"majority"` read concern has no effect on change
187185
streams availability.
188186
---
189187
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:: bash
6463

source/reference/read-concern-majority.txt

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -134,12 +134,11 @@ Read Your Own Writes
134134

135135
.. include:: /includes/fact-read-own-writes.rst
136136

137-
.. _disable-read-concern-majority:
138-
139-
140-
.. If you change this headline please also change the redirect that
137+
.. If you change this headline (below) please also change the redirect that
141138
.. links from #disable-read-concern-majority to this headline.
142139

140+
.. _disable-read-concern-majority:
141+
143142
Primary-Secondary-Arbiter Replica Sets
144143
--------------------------------------
145144

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

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,10 +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-
.. versionchanged:: 3.6
46-
47-
.. include:: /includes/fact-arbiter-priority.rst
48-
45+
.. include:: /includes/fact-arbiter-priority.rst
4946

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

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

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -29,32 +29,26 @@ 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

4947
.. include:: /includes/extracts/changestream-disable-rc-majority.rst
5048

5149
For more information on PSA architecture and read concern
52-
:readconcern:`"majority"`, see :ref:`disable-read-concern-majority`.
53-
54-
MongoDB 3.0 or Greater
55-
~~~~~~~~~~~~~~~~~~~~~~
56-
57-
.. include:: /includes/fact-wiredtiger-minimum-version.rst
50+
:readconcern:`"majority"`,
51+
see :ref:`disable-read-concern-majority`.
5852

5953
Default Bind to Localhost
6054
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -73,6 +67,8 @@ MMAPv1 Only Restrictions
7367

7468
.. include:: /includes/fact-mmapv1-only-restrictions.rst
7569

70+
.. _change-replica-set-wiredtiger-procedure:
71+
7672
Procedure
7773
---------
7874

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)