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``.

0 commit comments

Comments
 (0)