From 99032d5f0403f6a0a1ddc302b6e1c502baf2a4b3 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Mon, 23 Dec 2024 09:24:37 -0800 Subject: [PATCH 01/15] DOCSP-45861 Older Version Support Task Page --- source/includes/fact-pre-6.0-migration.rst | 2 + source/includes/table-patch-versions.rst | 23 ++++++++ .../includes/table-pre-6.0-compatibilty.rst | 27 +++++++++ source/reference/older-version-support.txt | 31 +++++++++++ source/reference/supported-server-version.txt | 55 +------------------ 5 files changed, 86 insertions(+), 52 deletions(-) create mode 100644 source/includes/fact-pre-6.0-migration.rst create mode 100644 source/includes/table-patch-versions.rst create mode 100644 source/includes/table-pre-6.0-compatibilty.rst create mode 100644 source/reference/older-version-support.txt diff --git a/source/includes/fact-pre-6.0-migration.rst b/source/includes/fact-pre-6.0-migration.rst new file mode 100644 index 000000000..492862c99 --- /dev/null +++ b/source/includes/fact-pre-6.0-migration.rst @@ -0,0 +1,2 @@ +Starting in version 1.10.0, ``mongosync`` supports migrations from pre-6.0 +source clusters. diff --git a/source/includes/table-patch-versions.rst b/source/includes/table-patch-versions.rst new file mode 100644 index 000000000..243a4cbed --- /dev/null +++ b/source/includes/table-patch-versions.rst @@ -0,0 +1,23 @@ +.. list-table:: + :header-rows: 1 + :class: compatibility + + * - Major Version + - Patch Version + - Minimum Feature Compatibility Version + + * - 4.4 + - 4.4.23 + - 4.4 + + * - 5.0 + - 5.0.29 + - 5.0 + + * - 6.0 + - 6.0.16 + - 6.0 + + * - 7.0 + - 7.0.9 + - 6.0 diff --git a/source/includes/table-pre-6.0-compatibilty.rst b/source/includes/table-pre-6.0-compatibilty.rst new file mode 100644 index 000000000..897f2690a --- /dev/null +++ b/source/includes/table-pre-6.0-compatibilty.rst @@ -0,0 +1,27 @@ +``mongosync`` supports syncs between the following source and +destination MongoDB server versions. + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 40 30 30 + + * - + - **6.0 Destination** + - **7.0 Destination** + + * - **4.4 Source** + - √ + - + + * - **5.0 Source** + - √ + - √ + + * - **6.0 Source** + - √ + - √ + + * - **7.0 Source** + - + - √ diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt new file mode 100644 index 000000000..56ef8ab1a --- /dev/null +++ b/source/reference/older-version-support.txt @@ -0,0 +1,31 @@ +.. _c2c-older-version-support: + +================================== +Migrate Data From Pre-6.0 Clusters +================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 2 + :class: singlecol + +.. include:: /includes/fact-pre-6.0-migration.rst + +Before You Begin +---------------- + +.. include:: /includes/table-pre-6.0-compatibilty.rst + +.. include:: /includes/table-patch-versions.rst + +Steps +----- + + +Learn More +---------- + +- :ref:`c2c-server-version-compatibility` diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index c0817a596..5894e1433 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -29,69 +29,20 @@ version limitations and requirements: The following table lists the minimum MongoDB server version requirements for clusters: -.. list-table:: - :header-rows: 1 - :class: compatibility - - * - Major Version - - Patch Version - - Minimum Feature Compatibility Version - - * - 4.4 - - 4.4.23 - - 4.4 - - * - 5.0 - - 5.0.29 - - 5.0 - - * - 6.0 - - 6.0.16 - - 6.0 - - * - 7.0 - - 7.0.9 - - 6.0 +.. include:: /includes/table-patch-versions.rst 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. +.. include:: /includes/fact-pre-6.0-migration.rst .. important:: ``mongosync`` does not support migrations to pre-6.0 destination clusters. -``mongosync`` supports syncs between the following source and -destination MongoDB server versions. - -.. list-table:: - :header-rows: 1 - :stub-columns: 1 - :widths: 40 30 30 - - * - - - **6.0 Destination** - - **7.0 Destination** - - * - **4.4 Source** - - √ - - - - * - **5.0 Source** - - √ - - √ - - * - **6.0 Source** - - √ - - √ - - * - **7.0 Source** - - - - √ +.. include:: /includes/table-pre-6.0-compatibilty.rst .. _c2c-server-pre-8.0-to-8.0: From 7ff6d7710bc44706ef40baee18880f3fdc48d664 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Thu, 2 Jan 2025 13:49:53 -0800 Subject: [PATCH 02/15] add prerequisites & limitations --- .../includes/table-pre-6.0-compatibilty.rst | 3 -- source/reference.txt | 1 + source/reference/limitations.txt | 6 +++- source/reference/older-version-support.txt | 31 ++++++++++++++++++- source/reference/supported-server-version.txt | 6 ++++ 5 files changed, 42 insertions(+), 5 deletions(-) diff --git a/source/includes/table-pre-6.0-compatibilty.rst b/source/includes/table-pre-6.0-compatibilty.rst index 897f2690a..2fd3ca213 100644 --- a/source/includes/table-pre-6.0-compatibilty.rst +++ b/source/includes/table-pre-6.0-compatibilty.rst @@ -1,6 +1,3 @@ -``mongosync`` supports syncs between the following source and -destination MongoDB server versions. - .. list-table:: :header-rows: 1 :stub-columns: 1 diff --git a/source/reference.txt b/source/reference.txt index 707bac529..95df154bf 100644 --- a/source/reference.txt +++ b/source/reference.txt @@ -61,6 +61,7 @@ Reference Reverse Sync Direction Limitations Logging + Migrate From Pre-6.0 Clusters User Permissions Telemetry Data Transfer Verification diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index f44222f54..eaef3adeb 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -203,8 +203,12 @@ Pre-6.0 Migrations Starting in 1.10, ``mongosync`` supports migrations from source clusters running MongoDB server versions older than 6.0. For information on supported migration -paths, see :ref:`c2c-server-version-compatibility`. +paths, see :ref:`c2c-older-version-support`. The following limitations apply to pre-6.0 migrations: .. include:: /includes/fact-older-version-limitations.rst + +.. seealso:: + + :ref:`c2c-server-version-compatibility` diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 56ef8ab1a..0b6db494d 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -14,16 +14,45 @@ Migrate Data From Pre-6.0 Clusters .. include:: /includes/fact-pre-6.0-migration.rst +About this Task +--------------- + +``mongosync`` supports syncs between the following source and +destination MongoDB server versions: + +.. include:: /includes/table-pre-6.0-compatibilty.rst + Before You Begin ---------------- -.. include:: /includes/table-pre-6.0-compatibilty.rst +Embedded Verifier +~~~~~~~~~~~~~~~~~ + +Before you sync from a pre-6.0 source cluster, enable the +:ref:`embedded verifier `. + +mongosync Version +~~~~~~~~~~~~~~~~~ + +If you are migrating from a pre-6.0 cluster, you must run ``mongosync`` 1.10 or +later. + +Server Version Compatibility +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Ensure that you are at least using a minimum supported server version on your +source and destination clusters: .. include:: /includes/table-patch-versions.rst +To learn more about supported server versions, see +:ref:`c2c-server-version-compatibility`. + Steps ----- +This example + Learn More ---------- diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 5894e1433..1f4917747 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -42,8 +42,14 @@ Synchronize Data Between Clusters with Different MongoDB Server Major Versions ``mongosync`` does not support migrations to pre-6.0 destination clusters. +``mongosync`` supports syncs between the following source and +destination MongoDB server versions. + .. include:: /includes/table-pre-6.0-compatibilty.rst +To learn more about syncing from pre-6.0 source clusters, see +:ref:`c2c-older-version-support`. + .. _c2c-server-pre-8.0-to-8.0: Synchronize Data From a Pre-8.0 Source Cluster to an 8.0 Destination Cluster From b68967e08ff5f9ff10b1548b13e28fba633b4d68 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Thu, 2 Jan 2025 13:50:51 -0800 Subject: [PATCH 03/15] * --- source/reference/limitations.txt | 2 ++ source/reference/older-version-support.txt | 1 + 2 files changed, 3 insertions(+) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index eaef3adeb..1c00835d8 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -198,6 +198,8 @@ cluster. .. include:: /includes/fact-verifier-limitations +.. _c2c-older-version-limitations: + Pre-6.0 Migrations ------------------ diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 0b6db494d..60039f3d4 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -57,4 +57,5 @@ This example Learn More ---------- +- :ref:`c2c-older-version-limitations` - :ref:`c2c-server-version-compatibility` From e9c9bd251d6e23c04dae1daeb1ce3bd008beeb2b Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 08:09:36 -0800 Subject: [PATCH 04/15] * --- source/reference/older-version-support.txt | 41 +++++++++++++++++----- 1 file changed, 32 insertions(+), 9 deletions(-) diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 60039f3d4..2d3d5e62a 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -25,17 +25,13 @@ destination MongoDB server versions: Before You Begin ---------------- +:ref:`Download and install ` ``mongosync`` 1.10 or later. + Embedded Verifier ~~~~~~~~~~~~~~~~~ Before you sync from a pre-6.0 source cluster, enable the -:ref:`embedded verifier `. - -mongosync Version -~~~~~~~~~~~~~~~~~ - -If you are migrating from a pre-6.0 cluster, you must run ``mongosync`` 1.10 or -later. +:ref:`embedded verifier `. Server Version Compatibility ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -51,11 +47,38 @@ To learn more about supported server versions, see Steps ----- -This example +In the following example, ``cluster0`` is an Atlas cluster running MongoDB 6.0, +and ``cluster1`` is an Atlas cluster running MongoDB 7.0. + +.. procedure:: + :style: normal + + .. step:: Format your connection strings + + The connection strings for the source and destination clusters should + resemble the following: + + .. code-block:: shell + + cluster0: + mongodb+srv://:@..mongodb.net + cluster1: + mongodb+srv://:@..mongodb.net + + .. step:: Connect the source and destination clusters with mongosync + + To connect ``cluster0`` to ``cluster1`` with ``mongosync``, enter the + following command on the command line: + .. code-block:: shell + + mongosync \ + --cluster0 "mongodb+srv://:@..mongodb.net" \ + --cluster1 "mongodb+srv://:@..mongodb.net" Learn More ---------- -- :ref:`c2c-older-version-limitations` +- :ref:`c2c-connecting` +- :ref:`Pre-6.0 Migration Limitations ` - :ref:`c2c-server-version-compatibility` From cecc399b1def34461c3a0555cfa410a123c8c843 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 09:23:30 -0800 Subject: [PATCH 05/15] procedures --- source/reference/older-version-support.txt | 51 +++++++++++++--------- 1 file changed, 31 insertions(+), 20 deletions(-) diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 2d3d5e62a..70899fb2e 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -36,7 +36,7 @@ Before you sync from a pre-6.0 source cluster, enable the Server Version Compatibility ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Ensure that you are at least using a minimum supported server version on your +Ensure that you are at least using a compatible patch version on your source and destination clusters: .. include:: /includes/table-patch-versions.rst @@ -47,34 +47,45 @@ To learn more about supported server versions, see Steps ----- -In the following example, ``cluster0`` is an Atlas cluster running MongoDB 6.0, -and ``cluster1`` is an Atlas cluster running MongoDB 7.0. +In the following example, ``cluster0`` is an source cluster running MongoDB 6.0, +and ``cluster1`` is a destination cluster running MongoDB 7.0. .. procedure:: :style: normal - .. step:: Format your connection strings + .. step:: Initialize ``mongosync`` + + Initialize the ``mongosync`` process: - The connection strings for the source and destination clusters should - resemble the following: + .. code-block:: sh - .. code-block:: shell - - cluster0: - mongodb+srv://:@..mongodb.net - cluster1: - mongodb+srv://:@..mongodb.net + mongosync \ + --logPath /var/log/mongosync \ + --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020" \ + --cluster1 "mongodb://clusterAdmin:superSecret@clusterTwo01.fancyCorp.com:20020,clusterTwo02.fancyCorp.com:20020,clusterTwo03.fancyCorp.com:20020" - .. step:: Connect the source and destination clusters with mongosync - To connect ``cluster0`` to ``cluster1`` with ``mongosync``, enter the - following command on the command line: + .. step:: Start the sync operation - .. code-block:: shell - - mongosync \ - --cluster0 "mongodb+srv://:@..mongodb.net" \ - --cluster1 "mongodb+srv://:@..mongodb.net" + To start syncing data from the source cluster to the + destination, use the :ref:`/start ` + endpoint. + + .. code-block:: sh + + curl localhost:27182/api/v1/start -XPOST \ + --data ' { + "source": "cluster0", + "destination": "cluster1", + } ' + + Example output: + + .. literalinclude:: /includes/api/responses/success.json + :language: json + :copyable: false + + .. step:: Learn More ---------- From 87d7ce1e92b905ee3b1917be2ab6ddb4daaab17a Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 09:28:39 -0800 Subject: [PATCH 06/15] * --- source/reference/older-version-support.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 70899fb2e..7887c50a0 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -9,7 +9,7 @@ Migrate Data From Pre-6.0 Clusters .. contents:: On this page :local: :backlinks: none - :depth: 2 + :depth: 1 :class: singlecol .. include:: /includes/fact-pre-6.0-migration.rst @@ -30,7 +30,7 @@ Before You Begin Embedded Verifier ~~~~~~~~~~~~~~~~~ -Before you sync from a pre-6.0 source cluster, enable the +When you sync from a pre-6.0 source cluster, enable the :ref:`embedded verifier `. Server Version Compatibility From dfabb7c25eb8a5e15561edab0887045b2724a41c Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 09:32:16 -0800 Subject: [PATCH 07/15] rn --- source/release-notes/1.10.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/release-notes/1.10.txt b/source/release-notes/1.10.txt index 667f7a33d..d0beeb1d1 100644 --- a/source/release-notes/1.10.txt +++ b/source/release-notes/1.10.txt @@ -19,6 +19,13 @@ Release Notes for mongosync 1.10 This page describes changes and new features introduced in {+c2c-full-product-name+} 1.10. +Older Version Support +--------------------- + +.. include:: /includes/fact-pre-6.0-migration.rst + +To learn more, see :ref:`c2c-older-version-support`. + Minimum Supported Version ------------------------- From abc6e9dcf053edaad811599355564f5b915609f3 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 09:36:00 -0800 Subject: [PATCH 08/15] * --- source/reference/limitations.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 1c00835d8..4cbba12ea 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -205,7 +205,7 @@ Pre-6.0 Migrations Starting in 1.10, ``mongosync`` supports migrations from source clusters running MongoDB server versions older than 6.0. For information on supported migration -paths, see :ref:`c2c-older-version-support`. +paths, see :ref:`c2c-server-version-compatibility`. The following limitations apply to pre-6.0 migrations: @@ -213,4 +213,4 @@ The following limitations apply to pre-6.0 migrations: .. seealso:: - :ref:`c2c-server-version-compatibility` + :ref:`c2c-older-version-support` From f0d17bf6be7b80e56fda312b0db5627c26d2a4e1 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 09:41:47 -0800 Subject: [PATCH 09/15] remove extra step --- source/reference/older-version-support.txt | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 7887c50a0..2bb64b9f8 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -85,8 +85,6 @@ and ``cluster1`` is a destination cluster running MongoDB 7.0. :language: json :copyable: false - .. step:: - Learn More ---------- From 2ff00dbaa7bc83721b0edabfea667f086f321e85 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 3 Jan 2025 11:24:28 -0800 Subject: [PATCH 10/15] nit --- source/reference/older-version-support.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 2bb64b9f8..4f6ee751f 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -47,7 +47,7 @@ To learn more about supported server versions, see Steps ----- -In the following example, ``cluster0`` is an source cluster running MongoDB 6.0, +In the following example, ``cluster0`` is a source cluster running MongoDB 6.0, and ``cluster1`` is a destination cluster running MongoDB 7.0. .. procedure:: From 348f706981edd393cf3193eb4efe5238faacb3b2 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Mon, 6 Jan 2025 08:13:44 -0800 Subject: [PATCH 11/15] AV feedback --- source/reference/older-version-support.txt | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt index 4f6ee751f..0602f101e 100644 --- a/source/reference/older-version-support.txt +++ b/source/reference/older-version-support.txt @@ -33,6 +33,12 @@ Embedded Verifier When you sync from a pre-6.0 source cluster, enable the :ref:`embedded verifier `. +Limitations +~~~~~~~~~~~ + +Before you migrate, review the :ref:`limitations +` for pre-6.0 migrations. + Server Version Compatibility ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -47,7 +53,7 @@ To learn more about supported server versions, see Steps ----- -In the following example, ``cluster0`` is a source cluster running MongoDB 6.0, +In the following example, ``cluster0`` is a source cluster running MongoDB 5.0, and ``cluster1`` is a destination cluster running MongoDB 7.0. .. procedure:: @@ -89,5 +95,4 @@ Learn More ---------- - :ref:`c2c-connecting` -- :ref:`Pre-6.0 Migration Limitations ` - :ref:`c2c-server-version-compatibility` From 9ff226ae4fc8b0b44da090c02f89a3cd052a994f Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 8 Jan 2025 14:28:26 -0800 Subject: [PATCH 12/15] remove task page --- source/reference/limitations.txt | 4 - source/reference/older-version-support.txt | 98 ------------------- source/reference/supported-server-version.txt | 7 +- source/release-notes/1.10.txt | 5 +- 4 files changed, 9 insertions(+), 105 deletions(-) delete mode 100644 source/reference/older-version-support.txt diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 4cbba12ea..476e0c2ac 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -210,7 +210,3 @@ paths, see :ref:`c2c-server-version-compatibility`. The following limitations apply to pre-6.0 migrations: .. include:: /includes/fact-older-version-limitations.rst - -.. seealso:: - - :ref:`c2c-older-version-support` diff --git a/source/reference/older-version-support.txt b/source/reference/older-version-support.txt deleted file mode 100644 index 0602f101e..000000000 --- a/source/reference/older-version-support.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _c2c-older-version-support: - -================================== -Migrate Data From Pre-6.0 Clusters -================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -.. include:: /includes/fact-pre-6.0-migration.rst - -About this Task ---------------- - -``mongosync`` supports syncs between the following source and -destination MongoDB server versions: - -.. include:: /includes/table-pre-6.0-compatibilty.rst - -Before You Begin ----------------- - -:ref:`Download and install ` ``mongosync`` 1.10 or later. - -Embedded Verifier -~~~~~~~~~~~~~~~~~ - -When you sync from a pre-6.0 source cluster, enable the -:ref:`embedded verifier `. - -Limitations -~~~~~~~~~~~ - -Before you migrate, review the :ref:`limitations -` for pre-6.0 migrations. - -Server Version Compatibility -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ensure that you are at least using a compatible patch version on your -source and destination clusters: - -.. include:: /includes/table-patch-versions.rst - -To learn more about supported server versions, see -:ref:`c2c-server-version-compatibility`. - -Steps ------ - -In the following example, ``cluster0`` is a source cluster running MongoDB 5.0, -and ``cluster1`` is a destination cluster running MongoDB 7.0. - -.. procedure:: - :style: normal - - .. step:: Initialize ``mongosync`` - - Initialize the ``mongosync`` process: - - .. code-block:: sh - - mongosync \ - --logPath /var/log/mongosync \ - --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020" \ - --cluster1 "mongodb://clusterAdmin:superSecret@clusterTwo01.fancyCorp.com:20020,clusterTwo02.fancyCorp.com:20020,clusterTwo03.fancyCorp.com:20020" - - - .. step:: Start the sync operation - - To start syncing data from the source cluster to the - destination, use the :ref:`/start ` - endpoint. - - .. code-block:: sh - - curl localhost:27182/api/v1/start -XPOST \ - --data ' { - "source": "cluster0", - "destination": "cluster1", - } ' - - Example output: - - .. literalinclude:: /includes/api/responses/success.json - :language: json - :copyable: false - -Learn More ----------- - -- :ref:`c2c-connecting` -- :ref:`c2c-server-version-compatibility` diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 1f4917747..40d1376b5 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -31,6 +31,8 @@ clusters: .. include:: /includes/table-patch-versions.rst +.. _c2c-sync-different-versions: + Synchronize Data Between Clusters with Different MongoDB Server Major Versions ------------------------------------------------------------------------------ @@ -47,8 +49,9 @@ destination MongoDB server versions. .. include:: /includes/table-pre-6.0-compatibilty.rst -To learn more about syncing from pre-6.0 source clusters, see -:ref:`c2c-older-version-support`. +.. seealso:: + + :ref:`c2c-older-version-limitations`. .. _c2c-server-pre-8.0-to-8.0: diff --git a/source/release-notes/1.10.txt b/source/release-notes/1.10.txt index d0beeb1d1..2b814fc13 100644 --- a/source/release-notes/1.10.txt +++ b/source/release-notes/1.10.txt @@ -24,7 +24,10 @@ Older Version Support .. include:: /includes/fact-pre-6.0-migration.rst -To learn more, see :ref:`c2c-older-version-support`. +To learn more, see: + +- :ref:`c2c-older-version-limitations`. +- :ref:`c2c-sync-different-versions`. Minimum Supported Version ------------------------- From 4de9d1992bb3d446632e81226b7bfbbfbae1f457 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 8 Jan 2025 14:32:07 -0800 Subject: [PATCH 13/15] * --- source/includes/table-patch-versions.rst | 23 --------- .../includes/table-pre-6.0-compatibilty.rst | 24 --------- source/reference.txt | 1 - source/reference/supported-server-version.txt | 51 +++++++++++++++++-- 4 files changed, 48 insertions(+), 51 deletions(-) delete mode 100644 source/includes/table-patch-versions.rst delete mode 100644 source/includes/table-pre-6.0-compatibilty.rst diff --git a/source/includes/table-patch-versions.rst b/source/includes/table-patch-versions.rst deleted file mode 100644 index 243a4cbed..000000000 --- a/source/includes/table-patch-versions.rst +++ /dev/null @@ -1,23 +0,0 @@ -.. list-table:: - :header-rows: 1 - :class: compatibility - - * - Major Version - - Patch Version - - Minimum Feature Compatibility Version - - * - 4.4 - - 4.4.23 - - 4.4 - - * - 5.0 - - 5.0.29 - - 5.0 - - * - 6.0 - - 6.0.16 - - 6.0 - - * - 7.0 - - 7.0.9 - - 6.0 diff --git a/source/includes/table-pre-6.0-compatibilty.rst b/source/includes/table-pre-6.0-compatibilty.rst deleted file mode 100644 index 2fd3ca213..000000000 --- a/source/includes/table-pre-6.0-compatibilty.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. list-table:: - :header-rows: 1 - :stub-columns: 1 - :widths: 40 30 30 - - * - - - **6.0 Destination** - - **7.0 Destination** - - * - **4.4 Source** - - √ - - - - * - **5.0 Source** - - √ - - √ - - * - **6.0 Source** - - √ - - √ - - * - **7.0 Source** - - - - √ diff --git a/source/reference.txt b/source/reference.txt index 95df154bf..707bac529 100644 --- a/source/reference.txt +++ b/source/reference.txt @@ -61,7 +61,6 @@ Reference Reverse Sync Direction Limitations Logging - Migrate From Pre-6.0 Clusters User Permissions Telemetry Data Transfer Verification diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index 40d1376b5..d73e05177 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -29,7 +29,29 @@ version limitations and requirements: The following table lists the minimum MongoDB server version requirements for clusters: -.. include:: /includes/table-patch-versions.rst +.. list-table:: + :header-rows: 1 + :class: compatibility + + * - Major Version + - Patch Version + - Minimum Feature Compatibility Version + + * - 4.4 + - 4.4.23 + - 4.4 + + * - 5.0 + - 5.0.29 + - 5.0 + + * - 6.0 + - 6.0.16 + - 6.0 + + * - 7.0 + - 7.0.9 + - 6.0 .. _c2c-sync-different-versions: @@ -45,9 +67,32 @@ Synchronize Data Between Clusters with Different MongoDB Server Major Versions ``mongosync`` does not support migrations to pre-6.0 destination clusters. ``mongosync`` supports syncs between the following source and -destination MongoDB server versions. +destination MongoDB server versions: + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 40 30 30 + + * - + - **6.0 Destination** + - **7.0 Destination** + + * - **4.4 Source** + - √ + - + + * - **5.0 Source** + - √ + - √ + + * - **6.0 Source** + - √ + - √ -.. include:: /includes/table-pre-6.0-compatibilty.rst + * - **7.0 Source** + - + - √ .. seealso:: From 1370c5a5d01e7dda785e955740951267925da079 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 10 Jan 2025 12:00:43 -0500 Subject: [PATCH 14/15] * --- .../includes/table-pre-6.0-compatibility.rst | 24 ++++++++++++++++++ source/reference/supported-server-version.txt | 25 +------------------ source/release-notes/1.10.txt | 5 ++++ 3 files changed, 30 insertions(+), 24 deletions(-) create mode 100644 source/includes/table-pre-6.0-compatibility.rst diff --git a/source/includes/table-pre-6.0-compatibility.rst b/source/includes/table-pre-6.0-compatibility.rst new file mode 100644 index 000000000..2fd3ca213 --- /dev/null +++ b/source/includes/table-pre-6.0-compatibility.rst @@ -0,0 +1,24 @@ +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 40 30 30 + + * - + - **6.0 Destination** + - **7.0 Destination** + + * - **4.4 Source** + - √ + - + + * - **5.0 Source** + - √ + - √ + + * - **6.0 Source** + - √ + - √ + + * - **7.0 Source** + - + - √ diff --git a/source/reference/supported-server-version.txt b/source/reference/supported-server-version.txt index d73e05177..d7cb687d6 100644 --- a/source/reference/supported-server-version.txt +++ b/source/reference/supported-server-version.txt @@ -69,30 +69,7 @@ Synchronize Data Between Clusters with Different MongoDB Server Major Versions ``mongosync`` supports syncs between the following source and destination MongoDB server versions: -.. list-table:: - :header-rows: 1 - :stub-columns: 1 - :widths: 40 30 30 - - * - - - **6.0 Destination** - - **7.0 Destination** - - * - **4.4 Source** - - √ - - - - * - **5.0 Source** - - √ - - √ - - * - **6.0 Source** - - √ - - √ - - * - **7.0 Source** - - - - √ +.. include:: /includes/table-pre-6.0-compatibility.rst .. seealso:: diff --git a/source/release-notes/1.10.txt b/source/release-notes/1.10.txt index 2b814fc13..217d05c7a 100644 --- a/source/release-notes/1.10.txt +++ b/source/release-notes/1.10.txt @@ -24,6 +24,11 @@ Older Version Support .. include:: /includes/fact-pre-6.0-migration.rst +``mongosync`` now supports syncs between the following source and +destination MongoDB server versions: + +.. include:: /includes/table-pre-6.0-compatibility.rst + To learn more, see: - :ref:`c2c-older-version-limitations`. From d29dd9555225e1a089b545c2d6da88313163b92e Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Fri, 10 Jan 2025 12:07:32 -0500 Subject: [PATCH 15/15] * --- source/release-notes/1.10.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/release-notes/1.10.txt b/source/release-notes/1.10.txt index 217d05c7a..5070f33d1 100644 --- a/source/release-notes/1.10.txt +++ b/source/release-notes/1.10.txt @@ -31,7 +31,7 @@ destination MongoDB server versions: To learn more, see: -- :ref:`c2c-older-version-limitations`. +- :ref:`Pre-6.0 Migration Limitations `. - :ref:`c2c-sync-different-versions`. Minimum Supported Version