Skip to content

Commit 99c653a

Browse files
authored
DOCSP-30384 MongoDB 7.0 Compatibility (#3370)
* DOCSP-30384 MongoDB 7.0 Compatibility * fixes version numbers * Adds downgrade link * Fixes per Sarah * Adds intra-node authentication section * Fixes per Kelsey/Alan * Fixes per Sarah * Fixes per Dave
1 parent 66069b8 commit 99c653a

File tree

3 files changed

+103
-21
lines changed

3 files changed

+103
-21
lines changed
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
2+
The following 7.0 features are not compatible with earlier versions of
3+
MongoDB. To downgrade from MongoDB 7.0 to an earlier version, you must
4+
remove data that uses any of the following features:
5+
6+
- :ref:`Capped collections <manual-capped-collection>` with a size that
7+
is not a multiple of 256 bytes
8+
9+
- Collections with ``encryptedFields`` with :ref:`range indexes
10+
<sharding-ranged>`
11+
12+
- Config servers that have collections with
13+
``changeStreamPreAndPostImages`` enabled
14+
15+
- Config shards
16+
17+
- Secondary :ref:`TTL indexes <index-feature-ttl>` with :ref:`partial
18+
filters <index-type-partial>` on :ref:`time series collections
19+
<manual-timeseries-collection>`
20+
21+
- Time series collections with custom bucketing parameters

source/release-notes/7.0-compatibility.txt

Lines changed: 81 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,84 @@ Compatibility Changes in MongoDB 7.0
1717
.. include:: includes/rc-available.rst
1818

1919
This page describes changes introduced in MongoDB 7.0 that can affect
20-
compatibility with older versions of MongoDB.
20+
compatibility with older versions of MongoDB.
21+
22+
MongoDB 7.0 is a |lts| Release, which means that it is supported for
23+
both MongoDB Atlas and on-premises deployments. MongoDB 7.0 includes
24+
changes introduced in MongoDB Rapid Releases 6.1, 6.2, and 6.3. This
25+
page describes compatibility changes introduced in those Rapid Releases
26+
and MongoDB 7.0.
27+
28+
To learn more about the differences between |lts| and Rapid Releases,
29+
see :ref:`release-version-numbers`.
30+
31+
For detail on downgrading from MongoDB 7.0, see :ref:`7.0-downgrade`.
32+
33+
Backward-Incompatible Features
34+
------------------------------
35+
36+
.. include:: /includes/fact-7.0-backwards-incompatible
37+
38+
Intra-Node Authentication
39+
-------------------------
40+
41+
Starting in MongoDB 7.0, you can configure servers to authetnicate
42+
X.509 certificates as cluster members identified by attributes or extension
43+
values. You can also override this configuration to accept alternate
44+
certificates during a rolling upgrade.
45+
46+
To downgrade to MongoDB 6.0, perform the certificate rotation procedure to unset
47+
the :setting:`net.tls.clusterAuthX509` setting and rotate the cluster
48+
membership certificates to ones with matching DC, O, and OU attributes.
49+
50+
Once this is complete, you can downgrade the cluster.
51+
52+
Time-Series
53+
-----------
54+
55+
- Remove partial TTL indexes from time series collections.
56+
57+
- Remove or modify collections using new index parameters. In some cases, you
58+
may use :dbcommand:`collMod` to switch to legacy granulairty settings, if not
59+
you need to drop the collection before downgrading.
60+
61+
Indexes
62+
-------
63+
64+
Remove columnar indexes from collections before downgrading the server.
65+
66+
Cluster Configuration
67+
---------------------
68+
69+
Active :parameter:`setClusterParameter` paramemter operations prevent
70+
feature Compatibility Version (fCV) from successful completion.
71+
72+
73+
Encrypted Multi-Map (EMM)
74+
--------------------------
75+
76+
Remove collections that use the ``encryptedFields`` collection option
77+
before downgrading.
78+
79+
Colocated Config Servers
80+
------------------------
81+
82+
Remove colocated config servers from the cluster before downgrading.
83+
84+
#. Run the :dbcommand:`transitionToDedicatedConfigServer` command
85+
to drain data from the config server.
86+
87+
Wait for the balancert o move all chunks off the config server.
88+
89+
#. Use the :dbcommand:`movePrimary` command to move databases off
90+
the config server.
91+
92+
#. Run the :dbcommand:`transitionToDedicatedConfigServer` command to complete
93+
the transition.
94+
95+
Wildcard Indexes
96+
----------------
97+
98+
Compound wildcard indexes require fCV 7.0 or greater. A pre-7.0
99+
:binary:`mongod` does not start if you are using one or more compound
100+
wildcard indexes.

source/release-notes/7.0.txt

Lines changed: 1 addition & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -329,26 +329,7 @@ Starting in MongoDB 7.0:
329329
Backward-Incompatible Features
330330
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
331331

332-
The following 7.0 features are not compatible with earlier versions of
333-
MongoDB. To downgrade from MongoDB 7.0 to an earlier version, you must
334-
remove data that uses any of the following features:
335-
336-
- Config shards
337-
338-
- Secondary :ref:`TTL indexes <index-feature-ttl>` with :ref:`partial
339-
filters <index-type-partial>` on :ref:`time-series collections
340-
<manual-timeseries-collection>`
341-
342-
- Time series collections with custom bucketing parameters
343-
344-
- Collections with ``encryptedFields`` with :ref:`range indexes
345-
<sharding-ranged>`
346-
347-
- :ref:`Capped collections <manual-capped-collection>` with a size that
348-
is not a multiple of 256 bytes
349-
350-
- Config servers that have collections with
351-
``changeStreamPreAndPostImages`` enabled
332+
.. include:: /includes/fact-7.0-backwards-incompatible
352333

353334
- Compound wildcard indexes require fCV 7.0 or greater. A pre-7.0
354335
:binary:`mongod` does not start if you are using one or more compound

0 commit comments

Comments
 (0)