From 87a08e63be8c32fd19509b7aa62ff47dc10a0680 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Fri, 14 Mar 2025 16:07:15 -0400 Subject: [PATCH 01/11] commit --- source/includes/fact-mongosync-balancer.rst | 25 ++++++++++++++++--- source/reference/limitations.txt | 22 ++++++++-------- .../mongosync/mongosync-behavior.txt | 25 ++++++++++++++++++- 3 files changed, 57 insertions(+), 15 deletions(-) diff --git a/source/includes/fact-mongosync-balancer.rst b/source/includes/fact-mongosync-balancer.rst index c408ef56b..3ba7f733c 100644 --- a/source/includes/fact-mongosync-balancer.rst +++ b/source/includes/fact-mongosync-balancer.rst @@ -1,7 +1,24 @@ .. important:: When the source or destination cluster is a sharded cluster, you must stop - the balancer on both clusters and not run the :dbcommand:`moveChunk` or - :dbcommand:`moveRange` commands for the duration of the migration. To stop - the balancer, run the :dbcommand:`balancerStop` command and wait for the - command to complete. + the source cluster's balancer on collections within the :ref:`namespace + filter `. You can enable the source cluster's balancer on + the cluster level and for collections outside the namespace filter. + You must also stop the destination cluster's balancer. + + If you enable the source cluster's balancer but do not use a + namespace filter, or if you disable the balancer for all + collections within the namespace filter, ``mongosync`` fails. + + During migration, do not run the :dbcommand:`moveChunk` or + :dbcommand:`moveRange` commands. If you have enabled the source cluster's + balancer, but disabled it for collections within the namespace + filter, do not run :dbcommand:`shardCollection` on collections + within the namespace filter. + + To stop the balancer, run the :dbcommand:`balancerStop` command + and wait for the command to complete. + + After stopping the balancer, wait fifteen minutes before + starting ``mongosync``. This gives the cluster time to + finish any in progress chunk migrations. diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 4386e9d67..e08193ad5 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -124,16 +124,18 @@ Sharded Clusters To check for index inconsistencies, see :ref:`Find Inconsistent Indexes Across Shards `. -- You must stop the balancer on sharded source and destination clusters - for the entire lifetime of a migration. To stop the balancer, run the - :dbcommand:`balancerStop` command and wait for the command to - complete. - - .. note:: - - After stopping the balancer, wait fifteen minutes before - starting ``mongosync``. This gives the cluster time to - finish any in progress chunk migrations. +- When the source or destination cluster is a sharded cluster, you must stop + the source cluster's balancer on collections within the :ref:`namespace + filter `. You can enable the source cluster's balancer on + the cluster level and for collections outside the namespace filter. + You must also stop the destination cluster's balancer. See + :ref:`enabling-balancer-filtered` to learn how to enable the balancer during + filtered sync. + +- If you have enabled the source cluster's + balancer, but disabled it for collections within the namespace + filter, do not run :dbcommand:`shardCollection` on collections + within the namespace filter. - 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 11374aba6..514149b4d 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -102,6 +102,29 @@ preserve the source cluster's sharding configuration. .. include:: /includes/fact-mongosync-balancer.rst +.. _enabling-balancer-filtered: + +Enabling Balancer in Filtered Sync +'''''''''''''''''''''''''''''''''' + +Before starting ``mongosync`` with a :ref:`namespace filter +`, enable the balancer for the source cluster +by running the :method:`sh.startBalancer()` method in ``mongosh``. +Then, disable the balancer for each collection within the +namespace filter by running the :dbcommand:`setAllowMigrations` command: + +.. code-block:: shell + + db.adminCommand( + { + setAllowMigrations: “.”, + allowMigrations: false + } + ) + +Run the preceding command for every collection within the +namespace filter. + Pre-Split Chunks '''''''''''''''' @@ -131,7 +154,7 @@ primary shard to each database by means of a round-robin. .. warning:: - Running :dbcommand:`movePrimary` on the source or desintation cluster + 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`. From 77494ff19b6f80d67677288523e78c2b1eb14e15 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Mon, 17 Mar 2025 14:26:04 -0400 Subject: [PATCH 02/11] small --- source/reference/limitations.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index e08193ad5..50f6ce8f9 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -128,6 +128,8 @@ Sharded Clusters the source cluster's balancer on collections within the :ref:`namespace filter `. You can enable the source cluster's balancer on the cluster level and for collections outside the namespace filter. + If you are not running a filtered sync, you must stop the source cluster's + balancer. You must also stop the destination cluster's balancer. See :ref:`enabling-balancer-filtered` to learn how to enable the balancer during filtered sync. From 5eb66120234c4e92780f100fc84da6a3771a46d4 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 18 Mar 2025 11:34:03 -0400 Subject: [PATCH 03/11] feedback --- source/includes/fact-mongosync-balancer.rst | 15 +++------------ source/reference/mongosync/mongosync-behavior.txt | 11 +++++++++++ 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/source/includes/fact-mongosync-balancer.rst b/source/includes/fact-mongosync-balancer.rst index 3ba7f733c..3f6f48730 100644 --- a/source/includes/fact-mongosync-balancer.rst +++ b/source/includes/fact-mongosync-balancer.rst @@ -6,19 +6,10 @@ the cluster level and for collections outside the namespace filter. You must also stop the destination cluster's balancer. - If you enable the source cluster's balancer but do not use a - namespace filter, or if you disable the balancer for all - collections within the namespace filter, ``mongosync`` fails. - During migration, do not run the :dbcommand:`moveChunk` or :dbcommand:`moveRange` commands. If you have enabled the source cluster's balancer, but disabled it for collections within the namespace filter, do not run :dbcommand:`shardCollection` on collections - within the namespace filter. - - To stop the balancer, run the :dbcommand:`balancerStop` command - and wait for the command to complete. - - After stopping the balancer, wait fifteen minutes before - starting ``mongosync``. This gives the cluster time to - finish any in progress chunk migrations. + within the namespace filter. If you run :dbcommand:`shardCollection` on + collections within the namespace filter during the migration, ``mongosync`` + returns an error and stops. \ No newline at end of file diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 514149b4d..1d0b2fa6e 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -125,6 +125,17 @@ namespace filter by running the :dbcommand:`setAllowMigrations` command: Run the preceding command for every collection within the namespace filter. +Then, run the :dbcommand:`balancerStop` command to stop +the balancer on the destination cluster and wait for the command to complete. + +After stopping the balancer, wait fifteen minutes before +starting ``mongosync``. This gives the cluster time to +finish any in progress chunk migrations. + +If you enable the source cluster's balancer but do not use a +namespace filter, or if you disable the balancer for all +collections within the namespace filter, ``mongosync`` fails. + Pre-Split Chunks '''''''''''''''' From 8ac0409407faca8842166a5b49828afe01f2a8ab Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 18 Mar 2025 13:34:47 -0400 Subject: [PATCH 04/11] error --- source/includes/fact-mongosync-balancer.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/includes/fact-mongosync-balancer.rst b/source/includes/fact-mongosync-balancer.rst index 3f6f48730..9cd3bbc79 100644 --- a/source/includes/fact-mongosync-balancer.rst +++ b/source/includes/fact-mongosync-balancer.rst @@ -12,4 +12,5 @@ filter, do not run :dbcommand:`shardCollection` on collections within the namespace filter. If you run :dbcommand:`shardCollection` on collections within the namespace filter during the migration, ``mongosync`` - returns an error and stops. \ No newline at end of file + returns an error and stops, which requires you to start the migration + from scratch. \ No newline at end of file From f1d0a43a322999b9d31aa1f1d1b7caaaf23a677d Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 18 Mar 2025 14:38:30 -0400 Subject: [PATCH 05/11] feedback --- source/reference/limitations.txt | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 50f6ce8f9..15a3a3de1 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -137,7 +137,10 @@ Sharded Clusters - If you have enabled the source cluster's balancer, but disabled it for collections within the namespace filter, do not run :dbcommand:`shardCollection` on collections - within the namespace filter. + within the namespace filter. If you run :dbcommand:`shardCollection` on + collections within the namespace filter during the migration, ``mongosync`` + returns an error and stops, which requires you to start the migration + from scratch. - You must not run the :dbcommand:`moveChunk` and :dbcommand:`moveRange` commands on the source or destination clusters. From a2ab127a164feebe519570678751c1ac621daed7 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Thu, 20 Mar 2025 10:22:15 -0400 Subject: [PATCH 06/11] feedback and restructure --- source/includes/fact-mongosync-balancer.rst | 21 +++-- source/reference/limitations.txt | 25 ++++-- .../mongosync/mongosync-behavior.txt | 83 +++++++++++-------- 3 files changed, 82 insertions(+), 47 deletions(-) diff --git a/source/includes/fact-mongosync-balancer.rst b/source/includes/fact-mongosync-balancer.rst index 9cd3bbc79..49319752d 100644 --- a/source/includes/fact-mongosync-balancer.rst +++ b/source/includes/fact-mongosync-balancer.rst @@ -1,10 +1,21 @@ .. important:: - When the source or destination cluster is a sharded cluster, you must stop - the source cluster's balancer on collections within the :ref:`namespace - filter `. You can enable the source cluster's balancer on - the cluster level and for collections outside the namespace filter. - You must also stop the destination cluster's balancer. + If the source or destination cluster is a sharded cluster + and you are not running ``mongosync`` with namespace filtering, + you must disable the source cluster's balancer + by running the :dbcommand:`balancerStop` command and waiting 15 minutes + for the command to complete. + + If the source or destination cluster is a sharded cluster and you + are running ``mongosync`` with :ref:`namespace + filtering `, you can enable the source cluster's + balancer overall but you must disable it for + all collections within the namespace filter. + See :ref:`disabling-balancer-filtered`. You can also disable + the source cluster's balancer. + + You must always disable the balancer on a sharded destination + cluster. During migration, do not run the :dbcommand:`moveChunk` or :dbcommand:`moveRange` commands. If you have enabled the source cluster's diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 15a3a3de1..191f38929 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -124,15 +124,22 @@ Sharded Clusters To check for index inconsistencies, see :ref:`Find Inconsistent Indexes Across Shards `. -- When the source or destination cluster is a sharded cluster, you must stop - the source cluster's balancer on collections within the :ref:`namespace - filter `. You can enable the source cluster's balancer on - the cluster level and for collections outside the namespace filter. - If you are not running a filtered sync, you must stop the source cluster's - balancer. - You must also stop the destination cluster's balancer. See - :ref:`enabling-balancer-filtered` to learn how to enable the balancer during - filtered sync. +- If the source or destination cluster is a sharded cluster + and you are not running ``mongosync`` with namespace filtering, + you must disable the source cluster's balancer + by running the :dbcommand:`balancerStop` command and waiting 15 minutes + for the command to complete. + + If the source or destination cluster is a sharded cluster and you + are running ``mongosync`` with :ref:`namespace + filtering `, you can enable the source cluster's + balancer overall but you must disable it for + all collections within the namespace filter. + See :ref:`disabling-balancer-filtered`. You can also disable + the source cluster's balancer. + + You must always disable the balancer on a sharded destination + cluster. - If you have enabled the source cluster's balancer, but disabled it for collections within the namespace diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 1d0b2fa6e..a75d61ab1 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -102,39 +102,56 @@ preserve the source cluster's sharding configuration. .. include:: /includes/fact-mongosync-balancer.rst -.. _enabling-balancer-filtered: - -Enabling Balancer in Filtered Sync -'''''''''''''''''''''''''''''''''' - -Before starting ``mongosync`` with a :ref:`namespace filter -`, enable the balancer for the source cluster -by running the :method:`sh.startBalancer()` method in ``mongosh``. -Then, disable the balancer for each collection within the -namespace filter by running the :dbcommand:`setAllowMigrations` command: - -.. code-block:: shell - - db.adminCommand( - { - setAllowMigrations: “.”, - allowMigrations: false - } - ) - -Run the preceding command for every collection within the -namespace filter. - -Then, run the :dbcommand:`balancerStop` command to stop -the balancer on the destination cluster and wait for the command to complete. - -After stopping the balancer, wait fifteen minutes before -starting ``mongosync``. This gives the cluster time to -finish any in progress chunk migrations. - -If you enable the source cluster's balancer but do not use a -namespace filter, or if you disable the balancer for all -collections within the namespace filter, ``mongosync`` fails. +.. _disabling-balancer-filtered: + +Disabling Balancer for Collections in Filtered Sync +''''''''''''''''''''''''''''''''''''''''''''''''''' + +If you want to enable the balancer for collections that are not +included in the namespace filter, use the following instructions before +starting ``mongosync``. These instructions allow you to enable the balancer +for the source cluster and disable the balancer for collections +within the namespace filter. + +.. procedure:: + + .. step:: Enable the balancer for the source cluster. + + Before starting ``mongosync`` with a :ref:`namespace filter + `, enable the balancer for the source cluster + by running the :method:`sh.startBalancer()` method in ``mongosh``. + + .. step:: Disable the balancer for each collection. + + Disable the balancer for each collection within the + namespace filter by running the :dbcommand:`setAllowMigrations` command: + + .. code-block:: shell + + db.adminCommand( + { + setAllowMigrations: “.”, + allowMigrations: false + } + ) + + Run the preceding command for every collection within the + namespace filter. + + .. step:: Stop the balancer on the destination cluster. + + Run the :dbcommand:`balancerStop` command to stop + the balancer on the destination cluster and wait + for the command to complete. + After stopping the balancer, wait **fifteen minutes** before + starting ``mongosync``. This gives the cluster time to + finish any in progress chunk migrations. + +.. important:: + + If you enable the source cluster's balancer but do not use a + namespace filter, or if you do not disable the balancer for all + collections within the namespace filter, ``mongosync`` fails. Pre-Split Chunks '''''''''''''''' From 21d08a525fc987ca8e867bc07d55d2d7e60dd8e0 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Thu, 20 Mar 2025 10:38:09 -0400 Subject: [PATCH 07/11] tweaks --- source/includes/fact-mongosync-balancer.rst | 8 ++++---- source/reference/limitations.txt | 8 ++++---- source/reference/mongosync/mongosync-behavior.txt | 8 +++++--- 3 files changed, 13 insertions(+), 11 deletions(-) diff --git a/source/includes/fact-mongosync-balancer.rst b/source/includes/fact-mongosync-balancer.rst index 49319752d..f1ba780ca 100644 --- a/source/includes/fact-mongosync-balancer.rst +++ b/source/includes/fact-mongosync-balancer.rst @@ -1,21 +1,21 @@ .. important:: If the source or destination cluster is a sharded cluster - and you are not running ``mongosync`` with namespace filtering, + and you are not running ``mongosync`` with :ref:`namespace + filtering `, you must disable the source cluster's balancer by running the :dbcommand:`balancerStop` command and waiting 15 minutes for the command to complete. If the source or destination cluster is a sharded cluster and you - are running ``mongosync`` with :ref:`namespace - filtering `, you can enable the source cluster's + are running ``mongosync`` with namespace filtering, you can enable the source cluster's balancer overall but you must disable it for all collections within the namespace filter. See :ref:`disabling-balancer-filtered`. You can also disable the source cluster's balancer. You must always disable the balancer on a sharded destination - cluster. + cluster by using :dbcommand:`balancerStop`. During migration, do not run the :dbcommand:`moveChunk` or :dbcommand:`moveRange` commands. If you have enabled the source cluster's diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 191f38929..3641a3eb3 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -125,21 +125,21 @@ Sharded Clusters Indexes Across Shards `. - If the source or destination cluster is a sharded cluster - and you are not running ``mongosync`` with namespace filtering, + and you are not running ``mongosync`` with :ref:`namespace + filtering `, you must disable the source cluster's balancer by running the :dbcommand:`balancerStop` command and waiting 15 minutes for the command to complete. If the source or destination cluster is a sharded cluster and you - are running ``mongosync`` with :ref:`namespace - filtering `, you can enable the source cluster's + are running ``mongosync`` with namespace filtering, you can enable the source cluster's balancer overall but you must disable it for all collections within the namespace filter. See :ref:`disabling-balancer-filtered`. You can also disable the source cluster's balancer. You must always disable the balancer on a sharded destination - cluster. + cluster by using :dbcommand:`balancerStop`. - If you have enabled the source cluster's balancer, but disabled it for collections within the namespace diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index a75d61ab1..7cf6aba07 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -107,13 +107,15 @@ preserve the source cluster's sharding configuration. Disabling Balancer for Collections in Filtered Sync ''''''''''''''''''''''''''''''''''''''''''''''''''' -If you want to enable the balancer for collections that are not -included in the namespace filter, use the following instructions before +If you are using a :ref:`namespace filter ` +and want to enable your source cluster's balancer, +use the following instructions before starting ``mongosync``. These instructions allow you to enable the balancer for the source cluster and disable the balancer for collections within the namespace filter. .. procedure:: + :style: normal .. step:: Enable the balancer for the source cluster. @@ -126,7 +128,7 @@ within the namespace filter. Disable the balancer for each collection within the namespace filter by running the :dbcommand:`setAllowMigrations` command: - .. code-block:: shell + .. code-block:: javascript db.adminCommand( { From f205361213d5cc6b1a4d5e3d19af7e4899e26370 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Thu, 20 Mar 2025 11:39:16 -0400 Subject: [PATCH 08/11] little tweak --- 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 7cf6aba07..6ab041344 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -147,7 +147,7 @@ within the namespace filter. for the command to complete. After stopping the balancer, wait **fifteen minutes** before starting ``mongosync``. This gives the cluster time to - finish any in progress chunk migrations. + finish any in-progress chunk migrations. .. important:: From f8975aadbf6d3a3ade0ba9b59f7d055c30186e00 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Thu, 20 Mar 2025 15:49:57 -0400 Subject: [PATCH 09/11] feedback --- source/includes/fact-mongosync-balancer.rst | 16 ++++++++++------ source/reference/limitations.txt | 7 ++++--- .../reference/mongosync/mongosync-behavior.txt | 7 +++---- 3 files changed, 17 insertions(+), 13 deletions(-) diff --git a/source/includes/fact-mongosync-balancer.rst b/source/includes/fact-mongosync-balancer.rst index f1ba780ca..fca039ea4 100644 --- a/source/includes/fact-mongosync-balancer.rst +++ b/source/includes/fact-mongosync-balancer.rst @@ -1,5 +1,11 @@ .. important:: + You must always disable the balancer on a sharded destination + cluster by using :dbcommand:`balancerStop`. + After stopping the balancer, wait **fifteen minutes** before + starting ``mongosync``. This gives the cluster time to + finish any in-progress chunk migrations. + If the source or destination cluster is a sharded cluster and you are not running ``mongosync`` with :ref:`namespace filtering `, @@ -8,15 +14,13 @@ for the command to complete. If the source or destination cluster is a sharded cluster and you - are running ``mongosync`` with namespace filtering, you can enable the source cluster's - balancer overall but you must disable it for + are running ``mongosync`` with namespace filtering, you can + globally enable the source cluster's + balancer but you must disable it for all collections within the namespace filter. - See :ref:`disabling-balancer-filtered`. You can also disable + See :ref:`disabling-balancer-filtered`. You can also fully disable the source cluster's balancer. - You must always disable the balancer on a sharded destination - cluster by using :dbcommand:`balancerStop`. - During migration, do not run the :dbcommand:`moveChunk` or :dbcommand:`moveRange` commands. If you have enabled the source cluster's balancer, but disabled it for collections within the namespace diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 3641a3eb3..05aa3c1b0 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -132,10 +132,11 @@ Sharded Clusters for the command to complete. If the source or destination cluster is a sharded cluster and you - are running ``mongosync`` with namespace filtering, you can enable the source cluster's - balancer overall but you must disable it for + are running ``mongosync`` with namespace filtering, you can + globally enable the source cluster's + balancer but you must disable it for all collections within the namespace filter. - See :ref:`disabling-balancer-filtered`. You can also disable + See :ref:`disabling-balancer-filtered`. You can also fully disable the source cluster's balancer. You must always disable the balancer on a sharded destination diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 6ab041344..8664efe68 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -108,11 +108,10 @@ Disabling Balancer for Collections in Filtered Sync ''''''''''''''''''''''''''''''''''''''''''''''''''' If you are using a :ref:`namespace filter ` -and want to enable your source cluster's balancer, +and want to enable your source cluster's balancer for +collections outside the namespace filter, use the following instructions before -starting ``mongosync``. These instructions allow you to enable the balancer -for the source cluster and disable the balancer for collections -within the namespace filter. +starting ``mongosync``. .. procedure:: :style: normal From a2764e60a4a715a5d33845b8ae335837b65cb058 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Thu, 20 Mar 2025 15:55:10 -0400 Subject: [PATCH 10/11] remove step --- source/reference/mongosync/mongosync-behavior.txt | 9 --------- 1 file changed, 9 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 8664efe68..30242e5ac 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -139,15 +139,6 @@ starting ``mongosync``. Run the preceding command for every collection within the namespace filter. - .. step:: Stop the balancer on the destination cluster. - - Run the :dbcommand:`balancerStop` command to stop - the balancer on the destination cluster and wait - for the command to complete. - After stopping the balancer, wait **fifteen minutes** before - starting ``mongosync``. This gives the cluster time to - finish any in-progress chunk migrations. - .. important:: If you enable the source cluster's balancer but do not use a From cb5f4e0c0cba2bf21f7cf39e6437e6c9d5d0bd54 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Mon, 24 Mar 2025 11:22:58 -0400 Subject: [PATCH 11/11] feedback --- source/reference/mongosync/mongosync-behavior.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 30242e5ac..6a567919e 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -110,8 +110,8 @@ Disabling Balancer for Collections in Filtered Sync If you are using a :ref:`namespace filter ` and want to enable your source cluster's balancer for collections outside the namespace filter, -use the following instructions before -starting ``mongosync``. +follow these instructions before +you start ``mongosync``. .. procedure:: :style: normal