@@ -17,4 +17,84 @@ Compatibility Changes in MongoDB 7.0
17
17
.. include:: includes/rc-available.rst
18
18
19
19
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.
0 commit comments