feedback

Author: mayaraman19

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 <c2c-filtered-sync>`,
@@ -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

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

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 <c2c-filtered-sync>`
-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