diff --git a/snooty.toml b/snooty.toml index 9db29470a..611abdd31 100644 --- a/snooty.toml +++ b/snooty.toml @@ -14,12 +14,12 @@ intersphinx = [ "https://www.mongodb.com/docs/atlas/objects.inv", toc_landing_pages = ["/quickstart", "/installation", - "reference/reference", + "/reference", "/connecting", "/topologies", "/using-mongosync", "/multiple-mongosyncs", - "/release-notes/release-notes", + "/release-notes", "/faq", "/reference/collection-level-filtering", "/reference/verification", @@ -28,10 +28,10 @@ toc_landing_pages = ["/quickstart", ] [constants] -version = "1.11" -version-previous = "1.10" -latest-version="1.11.0" -version-dev = "1.11" +version = "1.12" +version-previous = "1.11" +latest-version="1.12.0" +version-dev = "1.12" c2c-product-name = "Cluster-to-Cluster Sync" c2c-full-product-name = "MongoDB Cluster-to-Cluster Sync" mdb-download-center = "`MongoDB Download Center `__" diff --git a/source/includes/fact-partial-8.0-support.rst b/source/includes/fact-partial-8.0-support.rst deleted file mode 100644 index ce5562d42..000000000 --- a/source/includes/fact-partial-8.0-support.rst +++ /dev/null @@ -1,3 +0,0 @@ -Starting in version 1.10, ``mongosync`` supports migrations to destination -clusters that use MongoDB 8.0. The source must be a pre-8.0 cluster. -To migrate from 8.0 source clusters, see :ref:`c2c-server-8.0-to-8.0`. \ No newline at end of file diff --git a/source/includes/table-pre-6.0-compatibility.rst b/source/includes/table-pre-6.0-compatibility.rst index c41cbf831..927b41026 100644 --- a/source/includes/table-pre-6.0-compatibility.rst +++ b/source/includes/table-pre-6.0-compatibility.rst @@ -1,7 +1,7 @@ .. list-table:: :header-rows: 1 :stub-columns: 1 - :widths: 30 14 14 14 + :widths: 20 14 14 14 * - - **6.0 Destination** @@ -30,5 +30,5 @@ * - **8.0 Source** - - - - + - √ diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 361b09c0b..4386e9d67 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -200,6 +200,13 @@ cluster. .. include:: /includes/fact-verifier-limitations +Persistent Query Settings +------------------------- + +``mongosync`` doesn't migrate Persistent Query Settings (PQS), which were +introduced in MongoDB 8.0. If your source cluster uses PQS, you must +:ref:`migrate them manually `. + .. _c2c-older-version-limitations: Pre-6.0 Migrations diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index c77a353b8..8d184fda5 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -34,8 +34,6 @@ The :ref:`Frequently Asked Questions (FAQ) ` page addresses questions u Compatibility ------------- -- .. include:: /includes/fact-partial-8.0-support.rst - - .. include:: /includes/fact-minimum-server-version-support.rst You can migrate data on clusters (source) with versions of MongoDB diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 3beb8b5aa..6b94c63ac 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -13,9 +13,7 @@ MongoDB Server Version Compatibility :class: singlecol Before you run {+c2c-product-name+}, consider the following MongoDB server -version limitations and requirements: - -- .. include:: /includes/fact-partial-8.0-support.rst +version limitations and requirements: - Your source cluster must run one of the following major supported versions: @@ -23,6 +21,7 @@ version limitations and requirements: - 5.0 (*New in version 1.10.0*) - 6.0 - 7.0 + - 8.0 (*New in version 1.12.0*) - ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2. @@ -53,6 +52,10 @@ clusters: - 7.0.13 - 6.0 + * - 8.0 + - 8.0 + - 8.0 + .. _c2c-sync-different-versions: Synchronize Data Between Clusters with Different MongoDB Server Major Versions @@ -73,20 +76,4 @@ destination MongoDB server versions: .. seealso:: - :ref:`Pre-6.0 Migration Limitations ` - -.. _c2c-server-8.0-to-8.0: - -Synchronize Data Between Two 8.0 Clusters -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -To migrate data between two 8.0 clusters: - -- Use :ref:`mongodump` to export data from the source cluster. -- Use :ref:`mongorestore` to import the data into the destination cluster. - -For limitations on using ``mongodump`` and ``mongorestore``, see -:ref:`mongorestore-behavior-access-usage`. - -Alternatively, you can :ref:`downgrade your 8.0 source cluster <8.0-downgrade>` -to 7.0 and then migrate your data into an 8.0 destination cluster. + :ref:`Pre-6.0 Migration Limitations ` \ No newline at end of file diff --git a/source/release-notes.txt b/source/release-notes.txt index b74f919dd..4599b03d2 100644 --- a/source/release-notes.txt +++ b/source/release-notes.txt @@ -1,5 +1,3 @@ -.. place holder for the release notes TOC - ============= Release Notes ============= diff --git a/source/release-notes/1.12.txt b/source/release-notes/1.12.txt index ee1eda799..300024c56 100644 --- a/source/release-notes/1.12.txt +++ b/source/release-notes/1.12.txt @@ -20,6 +20,19 @@ This page describes changes and new features introduced in 1.12.0 Release -------------- +**February 19, 2025** + +MongoDB 8.0 support +~~~~~~~~~~~~~~~~~~~ + +{+c2c-full-product-name+} 1.12 adds support for MongoDB 8.0 on the source +cluster. However, it does not migrate Persistent Query Settings (PQS), which +are new in 8.0. If your source cluster uses PQS, you must :ref:`migrate them +manually `. + +For a full list of supported versions, see :ref:`c2c-server-version-compatibility`. + + ``enableUserWriteBlocking`` parameters ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -39,4 +52,16 @@ Live Upgrades ~~~~~~~~~~~~~ :ref:`Live upgrades ` -to version 1.12 are not supported. \ No newline at end of file +to version 1.12 are not supported. + +Other Notes +~~~~~~~~~~~ + +- Added a machine-friendly label to warnings about Persisted Query Settings + +Minimum Supported Version +------------------------- + +.. include:: /includes/fact-version-compatibility.rst + +.. include:: /includes/migration-upgrade-recommendation.rst