Skip to content

Commit 3b78491

Browse files
authored
DOCSP-37592 v4.4 Ref Removal (#6787) (#6817)
* DOCSP-37592 v4.4 Ref Removal * remove 'version 4.4' * track 'mongodb 4.4' * track 'v4.4' * remove rest * * * build errors * add ulimit note to include * hedged read copy * remove repetitive sentence * * * * * namespace * JD + IF feedback * add minimum-lts-version * final build errors
1 parent f2ff18c commit 3b78491

File tree

289 files changed

+992
-2539
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

289 files changed

+992
-2539
lines changed

snooty.toml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,7 @@ atlas-ui = "Atlas UI"
232232
mongosh = ":binary:`~bin.mongosh`"
233233
package-branch = "testing" # testing for dev rc releases
234234
windows-dir-version = "6.0" # wizard
235+
minimum-lts-version = "5.0"
235236
package-name-org = "mongodb-org"
236237
package-name-enterprise = "mongodb-enterprise"
237238
package-name = "mongodb"

source/administration/analyzing-mongodb-performance.txt

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -192,13 +192,12 @@ one or more of the following utilization statistics:
192192

193193
.. note::
194194

195-
Starting in MongoDB 4.4, if the :binary:`~bin.mongod` process runs
196-
in a :term:`container`, FTDC will report utilization statistics from
197-
the perspective of the container instead of the host operating
198-
system. For example, if a the :binary:`~bin.mongod` runs in a
199-
container that is configured with RAM restrictions, FTDC will
200-
calculate memory utilization against the container's RAM limit, as
201-
opposed to the host operating system's total available RAM.
195+
If the :binary:`~bin.mongod` process runs in a :term:`container`, FTDC
196+
reports utilization statistics from the perspective of the container
197+
instead of the host operating system. For example, if a the
198+
:binary:`~bin.mongod` runs in a container that is configured with RAM
199+
restrictions, FTDC calculates memory utilization against the container's
200+
RAM limit, as opposed to the host operating system's RAM limit.
202201

203202
FTDC collects statistics produced by the following commands on
204203
file rotation or startup:

source/administration/production-notes.txt

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -865,8 +865,7 @@ consider the following recommendations:
865865

866866
.. note::
867867

868-
Starting in MongoDB 4.4, a startup error is generated if the
869-
``ulimit`` value for number of open files is under ``64000``.
868+
.. include:: /includes/fact-ulimit-minimum.rst
870869

871870
- Disable Transparent Huge Pages. MongoDB performs better with
872871
normal (4096 bytes) virtual memory pages. See :doc:`Transparent Huge

source/core/aggregation-pipeline.txt

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -192,9 +192,8 @@ Some aggregation pipeline stages accept an :ref:`aggregation expression
192192
- Can contain additional nested :ref:`aggregation expressions
193193
<aggregation-expressions>`.
194194

195-
Starting in MongoDB 4.4, you can use the :group:`$accumulator` and
196-
:expression:`$function` aggregation operators to define custom
197-
aggregation expressions in JavaScript.
195+
You can use the :group:`$accumulator` and :expression:`$function` aggregation
196+
operators to define custom aggregation expressions in JavaScript.
198197

199198
For all aggregation expressions, see :ref:`aggregation-expressions`.
200199

source/core/csfle/reference/encryption-schemas.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,6 @@ Definition
168168
- ``bool``
169169
- ``object``
170170
- ``array``
171-
- ``javascriptWithScope`` (*Deprecated*)
172171

173172
If :autoencryptkeyword:`encrypt.algorithm` or its inherited value is
174173
``AED_AES_256_CBC_HMAC_SHA_512-Random``, ``bsonType`` is

source/core/csfle/reference/supported-operations.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -422,4 +422,3 @@ encrypted field to the following value types:
422422
- ``decimal128``
423423
- ``double``
424424
- ``object``
425-
- ``javascriptWithScope`` *(Deprecated)*

source/core/hashed-sharding.txt

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Hashed Sharding
99

1010
Hashed sharding uses either a :ref:`single field hashed index
1111
<index-hashed-index>` or a :ref:`compound hashed index
12-
<index-type-compound-hashed>` (*New in 4.4*) as the shard key to
12+
<index-type-compound-hashed>` as the shard key to
1313
partition data across your sharded cluster.
1414

1515
Sharding on a Single Field Hashed Index
@@ -28,7 +28,7 @@ Sharding on a Single Field Hashed Index
2828
value; this value is used as your shard key. [#hashvalue]_
2929

3030
Sharding on a Compound Hashed Index
31-
MongoDB 4.4 adds support for creating compound indexes with a single
31+
MongoDB includes support for creating compound indexes with a single
3232
:ref:`hashed field <index-type-hashed>`. To create a compound hashed
3333
index, specify ``hashed`` as the value of any single index key when
3434
creating the index.
@@ -119,11 +119,8 @@ hashed index to use as the :term:`shard key`:
119119

120120
- Starting in MongoDB 5.0, you can :ref:`reshard a collection
121121
<sharding-resharding>` by changing a collection's shard key.
122-
- Starting in MongoDB 4.4, you can :ref:`refine a shard key
123-
<shard-key-refine>` by adding a suffix field or fields to the
124-
existing shard key.
125-
- In MongoDB 4.2 and earlier, the choice of shard key cannot
126-
be changed after sharding.
122+
- You can :ref:`refine a shard key <shard-key-refine>` by adding a suffix
123+
field or fields to the existing shard key.
127124

128125
Shard a Populated Collection
129126
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/core/index-creation.txt

Lines changed: 13 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,11 @@ of the index build. The rest of the build process yields to interleaving
2222
read and write operations. For a detailed description of index build
2323
process and locking behavior, see :ref:`index-build-process`.
2424

25-
Starting in MongoDB 4.4, index builds on a replica set or sharded
26-
cluster build simultaneously across all data-bearing replica set
27-
members. The primary requires a minimum number of data-bearing voting
28-
members (i.e. commit quorum), including itself, that must complete the
29-
build before marking the index as ready for use. A "voting" member is
30-
any replica set member where :rsconf:`members[n].votes` is greater than
25+
Index builds on a replica set or sharded cluster build simultaneously across
26+
all data-bearing replica set members. The primary requires a minimum number of
27+
data-bearing voting members (i.e. commit quorum), including itself, that must
28+
complete the build before marking the index as ready for use. A "voting" member
29+
is any replica set member where :rsconf:`members[n].votes` is greater than
3130
``0``. See :ref:`index-operations-replicated-build` for more
3231
information.
3332

@@ -267,10 +266,7 @@ when it is restarted and continues from the saved checkpoint. In earlier
267266
versions, if the index build was interrupted it had to be restarted
268267
from the beginning.
269268

270-
Prior to MongoDB 4.4, the startup process stalls behind any recovered
271-
index builds. The secondary could fall out of sync with the replica set
272-
and require resynchronization. Starting in MongoDB 4.4, the
273-
:binary:`~bin.mongod` can perform the startup process while the
269+
The :binary:`~bin.mongod` can perform the startup process while the
274270
recovering index builds.
275271

276272
If you restart the :binary:`~bin.mongod` as a standalone (i.e. removing
@@ -297,18 +293,15 @@ there is still work to be done when the rollback concludes, the
297293
:binary:`~bin.mongod` automatically recovers the index build and
298294
continues from the saved checkpoint.
299295

300-
Starting in version 4.4, MongoDB can pause an in-progress
301-
index build to perform a :doc:`rollback </core/replica-set-rollbacks>`.
296+
MongoDB can pause an in-progress index build to perform a
297+
:doc:`rollback </core/replica-set-rollbacks>`.
302298

303299
- If the rollback does not revert the index build, MongoDB restarts
304300
the index build after completing the rollback.
305301

306302
- If the rollback reverts the index build, you must re-create the
307303
index or indexes after the rollback completes.
308304

309-
Prior to MongoDB 4.4, rollbacks could start only after all in-progress
310-
index builds finished.
311-
312305
.. _index-creation-index-consistency:
313306

314307
Index Consistency Checks for Sharded Collections
@@ -331,9 +324,8 @@ can occur, such as:
331324
fails to build the index for an associated shard or incorrectly
332325
builds an index with different specification.
333326

334-
Starting in MongoDB 4.4 (and in MongoDB 4.2.6), the :doc:`config server
335-
</core/sharded-cluster-config-servers>` primary periodically checks for
336-
index inconsistencies across the shards for sharded collections. To
327+
The :ref:`config server <sharding-config-server>` primary periodically checks
328+
for index inconsistencies across the shards for sharded collections. To
337329
configure these periodic checks, see
338330
:parameter:`enableShardedIndexConsistencyCheck` and
339331
:parameter:`shardedIndexConsistencyCheckIntervalMS`.
@@ -469,10 +461,9 @@ process:
469461
- A :binary:`~bin.mongod` that is *not* part of a replica set
470462
skips this stage.
471463

472-
Starting in MongoDB 4.4, the :binary:`~bin.mongod` submits a
473-
"vote" to the primary to commit the index. Specifically, it writes
474-
the "vote" to an internal replicated collection on the
475-
:term:`primary`.
464+
The :binary:`~bin.mongod` submits a "vote" to the primary to commit the
465+
index. Specifically, it writes the "vote" to an internal replicated
466+
collection on the :term:`primary`.
476467

477468
If the :binary:`~bin.mongod` is the :term:`primary`, it waits
478469
until it has a commit quorum of votes (all voting data-bearing

source/core/index-hidden.txt

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@ Hidden Indexes
1313
:depth: 1
1414
:class: singlecol
1515

16-
.. versionadded:: 4.4
17-
1816
Hidden indexes are not visible to the :doc:`query planner
1917
</core/query-plans>` and cannot be used to support a query.
2018

@@ -51,9 +49,7 @@ Restrictions
5149
------------
5250

5351
- To hide an index, you must have :ref:`featureCompatibilityVersion
54-
<view-fcv>` set to ``4.4`` or greater. However, once hidden, the
55-
index remains hidden even with :ref:`featureCompatibilityVersion
56-
<view-fcv>` set to ``4.2`` on MongoDB 4.4 binaries.
52+
<view-fcv>` set to ``{+minimum-lts-version+}`` or greater.
5753

5854
- You cannot hide the ``_id`` index.
5955

@@ -73,10 +69,8 @@ To create a ``hidden`` index, use the
7369

7470
To use the ``hidden`` option with
7571
:method:`db.collection.createIndex()`, you must have
76-
:ref:`featureCompatibilityVersion <view-fcv>` set to ``4.4`` or
77-
greater. However, once hidden, the index remains hidden even with
78-
:ref:`featureCompatibilityVersion <view-fcv>` set to ``4.2`` on
79-
MongoDB 4.4 binaries.
72+
:ref:`featureCompatibilityVersion <view-fcv>` set to
73+
``{+minimum-lts-version+}`` or greater.
8074

8175
For example, the following operation creates a hidden ascending index
8276
on the ``borough`` field:
@@ -129,9 +123,7 @@ Hide an Existing Index
129123
.. note::
130124

131125
- To hide an index, you must have :ref:`featureCompatibilityVersion
132-
<view-fcv>` set to ``4.4`` or greater. However, once hidden, the
133-
index remains hidden even with :ref:`featureCompatibilityVersion
134-
<view-fcv>` set to ``4.2`` on MongoDB 4.4 binaries.
126+
<view-fcv>` set to ``{+minimum-lts-version+}`` or greater.
135127

136128
- You cannot hide the ``_id`` index.
137129

source/core/kerberos.txt

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -216,11 +216,10 @@ for details.
216216
Testing and Verification
217217
------------------------
218218

219-
Introduced alongside MongoDB 4.4, the :binary:`~bin.mongokerberos`
220-
program provides a convenient method to verify your platform's Kerberos
221-
configuration for use with MongoDB, and to test that Kerberos
222-
authentication from a MongoDB client works as expected. See the
223-
:binary:`~bin.mongokerberos` documentation for more information.
219+
The :binary:`~bin.mongokerberos` program provides a convenient method to
220+
verify your platform's Kerberos configuration for use with MongoDB, and to
221+
test that Kerberos authentication from a MongoDB client works as expected.
222+
See the :binary:`~bin.mongokerberos` documentation for more information.
224223

225224
:binary:`~bin.mongokerberos` is available in MongoDB Enterprise only.
226225

source/core/map-reduce.txt

Lines changed: 0 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -68,20 +68,6 @@ mapping. Map-reduce operations can also use a custom JavaScript
6868
function to make final modifications to the results at the end of the
6969
map and reduce operation, such as perform additional calculations.
7070

71-
.. note::
72-
73-
Starting in MongoDB 4.4, :dbcommand:`mapReduce` no longer supports
74-
the deprecated BSON type JavaScript code with scope
75-
(:doc:`BSON type 15 </reference/bson-types/>`) for its functions. The
76-
``map``, ``reduce``, and ``finalize`` functions must be either BSON
77-
type String (:doc:`BSON type 2 </reference/bson-types/>`) or
78-
BSON type JavaScript (:doc:`BSON type 13 </reference/bson-types/>`).
79-
To pass constant values which will be accessible in the ``map``,
80-
``reduce``, and ``finalize`` functions, use the ``scope`` parameter.
81-
82-
The use of JavaScript code with scope for the :dbcommand:`mapReduce`
83-
functions has been deprecated since version 4.2.1.
84-
8571
Map-Reduce Results
8672
-------------------
8773

source/core/query-plans.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ Users can also:
152152
Plan Cache Debug Info Size Limit
153153
--------------------------------
154154

155-
Starting in MongoDB 5.0 (and 4.4.3, 4.2.12, 4.0.23, and 3.6.23), the
155+
Starting in MongoDB 5.0, the
156156
:doc:`plan cache </core/query-plans>` will save full ``plan cache``
157157
entries only if the cumulative size of the ``plan caches`` for all
158158
collections is lower than 0.5 GB. When the cumulative size of the

source/core/queryable-encryption/reference/supported-operations.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -433,4 +433,3 @@ following value types:
433433
- ``decimal128``
434434
- ``double``
435435
- ``object``
436-
- ``javascriptWithScope`` *(Deprecated)*

source/core/ranged-sharding.txt

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -54,12 +54,8 @@ to use as the :term:`shard key`.
5454

5555
- Starting in MongoDB 5.0, you can :ref:`reshard a collection
5656
<sharding-resharding>` by changing a collection's shard key.
57-
- Starting in MongoDB 4.4, you can :ref:`refine a shard key
58-
<shard-key-refine>` by adding a suffix field or fields to the existing
59-
shard key.
60-
- In MongoDB 4.2 and earlier, the choice of shard key cannot
61-
be changed after sharding.
62-
57+
- You can :ref:`refine a shard key <shard-key-refine>` by adding a suffix
58+
field or fields to the existing shard key.
6359

6460
Shard a Populated Collection
6561
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/core/read-preference-hedge-option.txt

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,18 @@ Hedged Read Option
66

77
.. default-domain:: mongodb
88

9-
Starting in MongoDB 4.4 for sharded clusters, you can specify the use
10-
of :ref:`hedged reads <mongos-hedged-reads>` for non-``primary``
11-
:doc:`read preferences </core/read-preference>`.
9+
You can specify the use of :ref:`hedged reads <mongos-hedged-reads>` for
10+
non-``primary`` :doc:`read preferences </core/read-preference>` on sharded
11+
clusters.
1212

1313
With hedged reads, the :binary:`~bin.mongos` instances can route read
1414
operations to two replica set members per each queried shard and return
1515
results from the first respondent per shard.
1616

1717
.. include:: /includes/list-hedged-reads-operations.rst
1818

19-
To specify hedged read for a read preference, MongoDB 4.4 introduces
20-
the hedged read option for read preferences.
19+
To specify hedged read for a read preference, use the hedged read option for
20+
read preferences.
2121

2222
Enable Hedged Reads
2323
-------------------

source/core/read-preference-mechanics.txt

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -76,13 +76,12 @@ settings. The read preference is re-evaluated for each operation.
7676
Hedged Reads
7777
````````````
7878

79-
Starting in version 4.4, :binary:`~bin.mongos` supports :ref:`hedged
80-
reads <mongos-hedged-reads>` for non-``primary`` :doc:`read preferences
81-
</core/read-preference>` modes. That is, :binary:`~bin.mongos` can send
82-
an additional read to another member, if available, to hedge the read
83-
operation if using non-``primary`` :doc:`read preferences
84-
</core/read-preference>`. The additional read sent to hedge the read
85-
operation uses the ``maxTimeMS`` value of
79+
:binary:`~bin.mongos` supports :ref:`hedged reads <mongos-hedged-reads>` for
80+
non-``primary`` :doc:`read preferences </core/read-preference>` modes.
81+
That is, :binary:`~bin.mongos` can send an additional read to another member,
82+
if available, to hedge the read operation if using non-``primary``
83+
:doc:`read preferences </core/read-preference>`. The additional read sent to
84+
hedge the read operation uses the ``maxTimeMS`` value of
8685
:parameter:`maxTimeMSForHedgedReads`.
8786

8887
.. include:: /includes/list-hedged-reads-operations.rst

source/core/read-preference.txt

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Read preference consists of the :ref:`read preference mode
2323
<replica-set-read-preference-tag-sets>`, the :ref:`maxStalenessSeconds
2424
<replica-set-read-preference-max-staleness>` option, and the
2525
:ref:`hedged read <read-preference-hedged-read>` option. :ref:`Hedged read
26-
<read-preference-hedged-read>` option is available for MongoDB 4.4+ sharded
26+
<read-preference-hedged-read>` option is available for sharded
2727
clusters for reads that use non-``primary`` read preference.
2828

2929
.. _read-pref-summary:
@@ -36,9 +36,8 @@ The following table lists a brief summary of the read preference modes:
3636

3737
.. note::
3838

39-
Starting in version 4.4, non-``primary`` read preference modes
40-
support :ref:`hedged read <mongos-hedged-reads>` on sharded
41-
clusters.
39+
Non-``primary`` read preference modes support
40+
:ref:`hedged read <mongos-hedged-reads>` on sharded clusters.
4241

4342
.. include:: /includes/read-preference-modes-table.rst
4443

@@ -114,7 +113,7 @@ Read Preference Modes
114113

115114
.. note::
116115

117-
Starting in version 4.4, :readmode:`primaryPreferred` supports
116+
Read preference :readmode:`primaryPreferred` supports
118117
:ref:`hedged reads <mongos-hedged-reads>` on sharded clusters.
119118

120119
.. readmode:: secondary
@@ -139,7 +138,7 @@ Read Preference Modes
139138

140139
.. note::
141140

142-
Starting in version 4.4, :readmode:`secondary` supports
141+
Read preference :readmode:`secondary` supports
143142
:ref:`hedged reads <mongos-hedged-reads>` on sharded clusters.
144143

145144
.. readmode:: secondaryPreferred
@@ -156,7 +155,7 @@ Read Preference Modes
156155

157156
.. note::
158157

159-
Starting in version 4.4, :readmode:`secondaryPreferred` supports
158+
Read preference :readmode:`secondaryPreferred` supports
160159
:ref:`hedged reads <mongos-hedged-reads>` on sharded clusters.
161160

162161
.. readmode:: nearest
@@ -193,7 +192,7 @@ Read Preference Modes
193192

194193
.. note::
195194

196-
Starting in version 4.4, read preference :readmode:`nearest`, by
195+
Read preference :readmode:`nearest`, by
197196
default, specifies the use of :ref:`hedged reads
198197
<mongos-hedged-reads>` for reads on a sharded cluster.
199198

source/core/replica-set-elections.txt

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -94,10 +94,9 @@ not seek election. For details, see
9494
Mirrored Reads
9595
~~~~~~~~~~~~~~
9696

97-
Starting in version 4.4, MongoDB provides :ref:`mirrored reads
98-
<mirrored-reads>` to pre-warm electable secondary members' cache with
99-
the most recently accessed data. With mirrored reads, the primary can
100-
mirror a subset of :ref:`operations
97+
MongoDB provides :ref:`mirrored reads <mirrored-reads>` to pre-warm
98+
electable secondary members' cache with the most recently accessed data.
99+
With mirrored reads, the primary can mirror a subset of :ref:`operations
101100
<mirrored-reads-supported-operations>` that it receives and send them
102101
to a subset of electable secondaries. Pre-warming the cache of a
103102
secondary can help restore performance more quickly after an election.

0 commit comments

Comments
 (0)