From 52e30e2087af139dce9c19a3801c8b9092ce8032 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Mon, 24 Mar 2025 13:50:35 -0400 Subject: [PATCH 1/8] DOCSP-48609-add-mongosync-notes --- source/reference/limitations.txt | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 05aa3c1b0..b88edd8cd 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -150,6 +150,9 @@ Sharded Clusters returns an error and stops, which requires you to start the migration from scratch. +- :dbcommand:`transitionFromDedicatedConfigServer` is not supported during + ``mongosync`` execution. + - You must not run the :dbcommand:`moveChunk` and :dbcommand:`moveRange` commands on the source or destination clusters. - The shard key cannot be :ref:`refined ` while From 411f10d2ff38459e2d14abb5cbe81327289cc339 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Mon, 24 Mar 2025 14:00:10 -0400 Subject: [PATCH 2/8] copy --- source/reference/mongosync/mongosync-behavior.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index fa15cab4a..ad621f638 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -172,6 +172,15 @@ Primary Shards When you sync to a sharded destination cluster, ``mongosync`` assigns a primary shard to each database by means of a round-robin. +Embedded Config Server Shards +''''''''''''''''''''''''''''' + +Starting in 8.0. MongoDB introduces support for embedded config server shards. + +``mongosync`` supports sync from dedicated config server sharded clusters to +embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` +supports sync from replica sets to embedded config sharded clusters. + .. warning:: Running :dbcommand:`movePrimary` on the source or destination cluster From 77dcf5087509db73fac0d8a110c9a33c0d4722a5 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Mon, 24 Mar 2025 14:23:02 -0400 Subject: [PATCH 3/8] move section --- source/reference/mongosync/mongosync-behavior.txt | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index ad621f638..5132e1418 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -172,6 +172,13 @@ Primary Shards When you sync to a sharded destination cluster, ``mongosync`` assigns a primary shard to each database by means of a round-robin. +.. warning:: + + Running :dbcommand:`movePrimary` on the source or destination cluster + during migration may result in a fatal error or require you to + restart the migration from the start. For more information, see + :ref:`c2c-sharded-limitations`. + Embedded Config Server Shards ''''''''''''''''''''''''''''' @@ -181,13 +188,6 @@ Starting in 8.0. MongoDB introduces support for embedded config server shards. embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` supports sync from replica sets to embedded config sharded clusters. -.. warning:: - - Running :dbcommand:`movePrimary` on the source or destination cluster - during migration may result in a fatal error or require you to - restart the migration from the start. For more information, see - :ref:`c2c-sharded-limitations`. - Multiple Clusters ~~~~~~~~~~~~~~~~~ From f5498c2ee119bbeb6e7b4d194be78d50eafd8226 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Mon, 24 Mar 2025 15:40:51 -0400 Subject: [PATCH 4/8] feedback --- source/reference/limitations.txt | 4 ++-- source/reference/mongosync/mongosync-behavior.txt | 4 +++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index b88edd8cd..a5bfbf0da 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -150,8 +150,8 @@ Sharded Clusters returns an error and stops, which requires you to start the migration from scratch. -- :dbcommand:`transitionFromDedicatedConfigServer` is not supported during - ``mongosync`` execution. +- ``mongosync`` doesn't support running the command :dbcommand:`transitionFromDedicatedConfigServer` + during ``mongosync`` execution. - You must not run the :dbcommand:`moveChunk` and :dbcommand:`moveRange` commands on the source or destination clusters. diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 5132e1418..b83972e4a 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -182,12 +182,14 @@ primary shard to each database by means of a round-robin. Embedded Config Server Shards ''''''''''''''''''''''''''''' -Starting in 8.0. MongoDB introduces support for embedded config server shards. +Starting in 8.0, MongoDB introduces support for embedded config server shards. ``mongosync`` supports sync from dedicated config server sharded clusters to embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` supports sync from replica sets to embedded config sharded clusters. +For more information, see :ref:`config-shard-concept`. + Multiple Clusters ~~~~~~~~~~~~~~~~~ From 6412d48aa5da3eac79fa96b84fbf396f93505757 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Mon, 24 Mar 2025 17:35:35 -0400 Subject: [PATCH 5/8] nits --- source/reference/limitations.txt | 2 +- source/reference/mongosync/mongosync-behavior.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index a5bfbf0da..d0c9be560 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -151,7 +151,7 @@ Sharded Clusters from scratch. - ``mongosync`` doesn't support running the command :dbcommand:`transitionFromDedicatedConfigServer` - during ``mongosync`` execution. + during execution. - You must not run the :dbcommand:`moveChunk` and :dbcommand:`moveRange` commands on the source or destination clusters. diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index b83972e4a..219fe3f8a 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -188,7 +188,7 @@ Starting in 8.0, MongoDB introduces support for embedded config server shards. embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` supports sync from replica sets to embedded config sharded clusters. -For more information, see :ref:`config-shard-concept`. +To learn more about embedded config servers, see :ref:`config-shard-concept`. Multiple Clusters ~~~~~~~~~~~~~~~~~ From dd8e82f7bec117f303472299c70e7da84a331360 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Tue, 25 Mar 2025 14:55:08 -0400 Subject: [PATCH 6/8] feedback --- source/reference/mongosync/mongosync-behavior.txt | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 219fe3f8a..43ca37ee5 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -179,16 +179,14 @@ primary shard to each database by means of a round-robin. restart the migration from the start. For more information, see :ref:`c2c-sharded-limitations`. -Embedded Config Server Shards -''''''''''''''''''''''''''''' +Config Shard Cluster +'''''''''''''''''''' -Starting in 8.0, MongoDB introduces support for embedded config server shards. +Starting in 8.0, MongoDB introduces support for :ref:`config-shard-concept`. ``mongosync`` supports sync from dedicated config server sharded clusters to -embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` -supports sync from replica sets to embedded config sharded clusters. - -To learn more about embedded config servers, see :ref:`config-shard-concept`. +config server sharded clusters and vice versa. Additionally, ``mongosync`` +supports sync from replica sets to config sharded clusters. Multiple Clusters ~~~~~~~~~~~~~~~~~ From 6be33114dea29cc538311ec39ac74ab1a1a1f981 Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Tue, 25 Mar 2025 15:14:21 -0400 Subject: [PATCH 7/8] feedback --- source/reference/mongosync/mongosync-behavior.txt | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 43ca37ee5..02676b72d 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -182,12 +182,15 @@ primary shard to each database by means of a round-robin. Config Shard Cluster '''''''''''''''''''' -Starting in 8.0, MongoDB introduces support for :ref:`config-shard-concept`. +Starting in 8.0, MongoDB introduces support for config shard clusters, also known +as embedded config server clusters. ``mongosync`` supports sync from dedicated config server sharded clusters to -config server sharded clusters and vice versa. Additionally, ``mongosync`` +embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` supports sync from replica sets to config sharded clusters. +To learn more about embedded config servers, see :ref:`config-shard-concept`. + Multiple Clusters ~~~~~~~~~~~~~~~~~ From d6bb86e73edc3aa2e699fd57eec99c0abbc0bd3d Mon Sep 17 00:00:00 2001 From: Grace Miller Date: Thu, 27 Mar 2025 09:29:20 -0400 Subject: [PATCH 8/8] add --- source/reference/mongosync/mongosync-behavior.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 02676b72d..704257c64 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -187,7 +187,7 @@ as embedded config server clusters. ``mongosync`` supports sync from dedicated config server sharded clusters to embedded config server sharded clusters and vice versa. Additionally, ``mongosync`` -supports sync from replica sets to config sharded clusters. +supports sync from replica sets to config sharded clusters, but not vice versa. To learn more about embedded config servers, see :ref:`config-shard-concept`.