From cec5ec5833c9ce48a85f6af643acd6400d94b953 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Tue, 10 Dec 2024 14:50:15 -0500 Subject: [PATCH 1/7] DOCSP-45859 Version Compatibility --- .../includes/fact-version-compatibility.rst | 2 + source/reference/mongosync.txt | 2 - source/reference/supported-server-version.txt | 50 +++++++++++++++---- source/release-notes/1.10.txt | 9 +++- 4 files changed, 50 insertions(+), 13 deletions(-) create mode 100644 source/includes/fact-version-compatibility.rst diff --git a/source/includes/fact-version-compatibility.rst b/source/includes/fact-version-compatibility.rst new file mode 100644 index 000000000..eeed144f5 --- /dev/null +++ b/source/includes/fact-version-compatibility.rst @@ -0,0 +1,2 @@ +For information on minimum supported versions, see +:ref:`c2c-server-version-compatibility`. diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 9bace82c5..0c638a9fe 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -38,8 +38,6 @@ Compatibility ------------- - .. include:: /includes/fact-no-8.0-support.rst - -- .. include:: /includes/fact-minimum-server-version-support.rst You can migrate data on clusters (source) with versions of MongoDB lower than 6.0 to an Atlas cluster (destination). Migration from clusters with diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 1ebb36a8b..475109304 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -17,23 +17,45 @@ version limitations and requirements: - .. include:: /includes/fact-no-8.0-support.rst -- .. include:: /includes/fact-minimum-server-version-support.rst - - ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2. -- .. include:: /includes/fact-minimum-fcv.rst - -Synchronize Data Between Clusters Running Older MongoDB Server Versions -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /includes/fact-minimum-versions.rst +Minimum Supported Versions +-------------------------- +.. list-table:: + :header-rows: 1 + :class: compatibility + + * - Major Version + - 4.4 + - 5.0 + - 6.0 + - 7.0 + + * - Minimum Supported Patch Version + - 4.4.23 + - 5.0.29 + - 6.0.16 + - 7.0.9 + + * - Minimum :ref:`Feature Compatibility Version ` + - 4.4 + - 5.0 + - 6.0 + - 6.0 Synchronize Data Between Clusters with Different MongoDB Server Major Versions -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------------------------------------------------------------ .. include:: /includes/cross-version-sync.rst +Starting in version 1.10.0, ``mongosync`` supports migrations from pre-6.0 +source clusters. + +- 4.4 source clusters to 6.0 destination clusters +- 5.0 source clusters to 6.0 destination clusters +- 5.0 source clusters to 7.0 destination clusters + ``mongosync`` supports syncs between the following source and destination MongoDB server versions. @@ -42,10 +64,18 @@ destination MongoDB server versions. :stub-columns: 1 :widths: 40 30 30 - * - + * - - **6.0** Destination - **7.0** Destination + * - **4.4** Source + - √ + - + + * - **5.0** Source + - √ + - √ + * - **6.0** Source - √ - √ diff --git a/source/release-notes/1.10.txt b/source/release-notes/1.10.txt index 58842d615..1d6731a68 100644 --- a/source/release-notes/1.10.txt +++ b/source/release-notes/1.10.txt @@ -17,4 +17,11 @@ Release Notes for mongosync 1.10 .. _1.10.0-c2c-release-notes: This page describes changes and new features introduced in -{+c2c-full-product-name+} 1.10 and the {+c2c-full-beta-program+}. \ No newline at end of file +{+c2c-full-product-name+} 1.10 and the {+c2c-full-beta-program+}. + +Minimum Supported Version +------------------------- + +.. include:: /includes/fact-version-compatibility.rst + +.. include:: /includes/migration-upgrade-recommendation.rst From afd5b01f80cb6e53a038eee64994abfab60111c1 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Tue, 10 Dec 2024 14:57:29 -0500 Subject: [PATCH 2/7] * --- source/includes/fact-minimum-fcv.rst | 2 -- source/reference/supported-server-version.txt | 26 +++++++++---------- 2 files changed, 12 insertions(+), 16 deletions(-) delete mode 100644 source/includes/fact-minimum-fcv.rst diff --git a/source/includes/fact-minimum-fcv.rst b/source/includes/fact-minimum-fcv.rst deleted file mode 100644 index 4cbdd41d5..000000000 --- a/source/includes/fact-minimum-fcv.rst +++ /dev/null @@ -1,2 +0,0 @@ -The minimum supported server :ref:`feature compatibility version ` -is 6.0. diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 475109304..8fb2cba04 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -27,22 +27,24 @@ Minimum Supported Versions :class: compatibility * - Major Version - - 4.4 - - 5.0 - - 6.0 - - 7.0 + - Minimum Supported Patch Version + - Minimum :ref:`Feature Compatibility Version ` - * - Minimum Supported Patch Version + * - 4.4 - 4.4.23 + - 4.4 + + * - 5.0 - 5.0.29 + - 5.0 + + * - 6.0 - 6.0.16 - - 7.0.9 + - 6.0 - * - Minimum :ref:`Feature Compatibility Version ` - - 4.4 - - 5.0 + * - 7.0 + - 7.0.9 - 6.0 - - 6.0 Synchronize Data Between Clusters with Different MongoDB Server Major Versions ------------------------------------------------------------------------------ @@ -52,10 +54,6 @@ Synchronize Data Between Clusters with Different MongoDB Server Major Versions Starting in version 1.10.0, ``mongosync`` supports migrations from pre-6.0 source clusters. -- 4.4 source clusters to 6.0 destination clusters -- 5.0 source clusters to 6.0 destination clusters -- 5.0 source clusters to 7.0 destination clusters - ``mongosync`` supports syncs between the following source and destination MongoDB server versions. From 3171687117d213fb179791a46814c0521e368208 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Tue, 10 Dec 2024 16:03:17 -0500 Subject: [PATCH 3/7] * --- source/reference/supported-server-version.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 8fb2cba04..e77caa564 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -19,16 +19,23 @@ version limitations and requirements: - ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2. -Minimum Supported Versions --------------------------- +- Your source cluster must run one of the following major supported versions: + + - 4.4 (*New in version 1.10.0*) + - 5.0 (*New in version 1.10.0*) + - 6.0 + - 7.0 + +The following table lists the minimum MongoDB server version requirements for +source clusters: .. list-table:: :header-rows: 1 :class: compatibility * - Major Version - - Minimum Supported Patch Version - - Minimum :ref:`Feature Compatibility Version ` + - Patch Version + - Minimum Feature Compatibility Version * - 4.4 - 4.4.23 From 505ad1198e8a992ff07ec1638638aa5089bbfe8f Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Tue, 10 Dec 2024 16:13:23 -0500 Subject: [PATCH 4/7] * --- source/reference/supported-server-version.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index e77caa564..dfd6d9c21 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -70,22 +70,22 @@ destination MongoDB server versions. :widths: 40 30 30 * - - - **6.0** Destination - - **7.0** Destination + - **6.0 Destination** + - **7.0 Destination** - * - **4.4** Source + * - **4.4 Source** - √ - - * - **5.0** Source + * - **5.0 Source** - √ - √ - * - **6.0** Source + * - **6.0 Source** - √ - √ - * - **7.0** Source + * - **7.0 Source** - - √ From 2d9714ce0b989175c0d3a1a4538dcccc4b727fa5 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 11 Dec 2024 11:39:13 -0500 Subject: [PATCH 5/7] AV feedback --- source/includes/cross-version-sync.rst | 6 ------ source/reference/supported-server-version.txt | 6 +++++- 2 files changed, 5 insertions(+), 7 deletions(-) diff --git a/source/includes/cross-version-sync.rst b/source/includes/cross-version-sync.rst index af84c63a5..646a8aa8b 100644 --- a/source/includes/cross-version-sync.rst +++ b/source/includes/cross-version-sync.rst @@ -1,9 +1,3 @@ Starting in 1.7.0, ``mongosync`` can perform version migration from certain lower major version source clusters to certain higher major version destination clusters. - -Cross-version migration requires additional preparation and -configuration when migrating from a pre-6.0 release. To perform a cross-version -migration from a pre-6.0 version of the MongoDB Server using -``mongosync``, please `contact `__ your -account team to inquire about Professional Services. diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index dfd6d9c21..96f5867fc 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -27,7 +27,7 @@ version limitations and requirements: - 7.0 The following table lists the minimum MongoDB server version requirements for -source clusters: +clusters: .. list-table:: :header-rows: 1 @@ -61,6 +61,10 @@ Synchronize Data Between Clusters with Different MongoDB Server Major Versions Starting in version 1.10.0, ``mongosync`` supports migrations from pre-6.0 source clusters. +.. important:: + + ``mongosync`` does not support migrations to pre-6.0 destination clusters. + ``mongosync`` supports syncs between the following source and destination MongoDB server versions. From 6d3e7ec7681ff67366297b16881241871f679d37 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 11 Dec 2024 11:45:16 -0500 Subject: [PATCH 6/7] swap list order --- source/reference/supported-server-version.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 96f5867fc..c0817a596 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -17,8 +17,6 @@ version limitations and requirements: - .. include:: /includes/fact-no-8.0-support.rst -- ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2. - - Your source cluster must run one of the following major supported versions: - 4.4 (*New in version 1.10.0*) @@ -26,6 +24,8 @@ version limitations and requirements: - 6.0 - 7.0 +- ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2. + The following table lists the minimum MongoDB server version requirements for clusters: From 50e612f9d0f2d7bb80dacf378900726437a5465a Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Tue, 17 Dec 2024 15:53:05 -0500 Subject: [PATCH 7/7] MvK feedback --- source/reference/mongosync.txt | 8 -------- source/release-notes/1.10.txt | 2 +- 2 files changed, 1 insertion(+), 9 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 0c638a9fe..43ecdf87b 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -38,14 +38,6 @@ Compatibility ------------- - .. include:: /includes/fact-no-8.0-support.rst - - You can migrate data on clusters (source) with versions of MongoDB - lower than 6.0 to an Atlas cluster (destination). Migration from clusters with - lower version requires additional preparation and configuration in - the clusters with the lower version. `Contact - `__ your account team to inquire about - Professional Services. - - ``mongosync`` supports replica sets and sharded clusters. - Standalone MongoDB instances are not supported. :ref:`Convert the standalone instance ` to a diff --git a/source/release-notes/1.10.txt b/source/release-notes/1.10.txt index 1d6731a68..667f7a33d 100644 --- a/source/release-notes/1.10.txt +++ b/source/release-notes/1.10.txt @@ -17,7 +17,7 @@ Release Notes for mongosync 1.10 .. _1.10.0-c2c-release-notes: This page describes changes and new features introduced in -{+c2c-full-product-name+} 1.10 and the {+c2c-full-beta-program+}. +{+c2c-full-product-name+} 1.10. Minimum Supported Version -------------------------