From 43225b61e614871df7228671709b8ecc8d381961 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 18 Mar 2025 15:55:50 -0400 Subject: [PATCH 1/7] commit --- source/reference/mongosync/mongosync-behavior.txt | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 11374aba6..ef110ac47 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -113,6 +113,11 @@ destination cluster. Chunk Distribution '''''''''''''''''' +.. important:: + + Even if ``mongosync`` balances the source cluster, it does not + necessarily balance the destination cluster. + ``mongosync`` does not preserve chunk distribution from the source to the destination, even with multiple ``mongosync`` instances. It is not possible to reproduce a particular pre-split of chunks from a source From f3b55a1251b6242ff7a440b818c192dc66701cc2 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 18 Mar 2025 17:18:05 -0400 Subject: [PATCH 2/7] feedback --- source/reference/mongosync/mongosync-behavior.txt | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index ef110ac47..185a6203f 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -116,7 +116,9 @@ Chunk Distribution .. important:: Even if ``mongosync`` balances the source cluster, it does not - necessarily balance the destination cluster. + balance the destination cluster. To balance the destination + cluster, enable the destination cluster's balancer after your + migration finishes. ``mongosync`` does not preserve chunk distribution from the source to the destination, even with multiple ``mongosync`` instances. It is not From 3a557edec87f5b01c78add32ce2ef3058e6e9edb Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Thu, 20 Mar 2025 15:22:10 -0400 Subject: [PATCH 3/7] feedbaclk --- 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 185a6203f..54eae2a47 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -115,8 +115,8 @@ Chunk Distribution .. important:: - Even if ``mongosync`` balances the source cluster, it does not - balance the destination cluster. To balance the destination + Even if the source cluster is balanced, ``mongosync`` does not + ensure balance of the destination cluster. To balance the destination cluster, enable the destination cluster's balancer after your migration finishes. From ba56ebb124271df0fd25464d4c2f31b7dd050bbe Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 25 Mar 2025 10:34:55 -0400 Subject: [PATCH 4/7] feedback --- 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 54eae2a47..890293e78 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -118,7 +118,7 @@ Chunk Distribution Even if the source cluster is balanced, ``mongosync`` does not ensure balance of the destination cluster. To balance the destination cluster, enable the destination cluster's balancer after your - migration finishes. + migration finishes by running the :dbcommand:`balancerStart` command. ``mongosync`` does not preserve chunk distribution from the source to the destination, even with multiple ``mongosync`` instances. It is not From 753ac9c76596af628ea5b0e73879ed60addf0059 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 25 Mar 2025 11:41:05 -0400 Subject: [PATCH 5/7] feedback --- source/reference/mongosync/mongosync-behavior.txt | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 890293e78..5436993c2 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -116,9 +116,11 @@ Chunk Distribution .. important:: Even if the source cluster is balanced, ``mongosync`` does not - ensure balance of the destination cluster. To balance the destination - cluster, enable the destination cluster's balancer after your - migration finishes by running the :dbcommand:`balancerStart` command. + ensure balance of the destination cluster. Because ``mongosync`` + does not support the execution of sharding operations during + migration, you must wait until it is safe to accept writes + to rebalance the destination cluster. See :ref:`sharding-balancing` + for guidance on how to rebalance the cluster. ``mongosync`` does not preserve chunk distribution from the source to the destination, even with multiple ``mongosync`` instances. It is not From f4b717265f487e0a9fe461d127ec4967c07e4127 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Tue, 25 Mar 2025 14:04:04 -0400 Subject: [PATCH 6/7] link --- source/reference/mongosync/mongosync-behavior.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 5436993c2..5253c5e3a 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -120,7 +120,8 @@ Chunk Distribution does not support the execution of sharding operations during migration, you must wait until it is safe to accept writes to rebalance the destination cluster. See :ref:`sharding-balancing` - for guidance on how to rebalance the cluster. + for guidance on how to rebalance the cluster and :ref:`c2c-sharded-limitations` + for information on sharded cluster limitations in ``mongosync``. ``mongosync`` does not preserve chunk distribution from the source to the destination, even with multiple ``mongosync`` instances. It is not From d319f05f980b287b8f4590d02070ad42e6a88b23 Mon Sep 17 00:00:00 2001 From: Maya Raman Date: Wed, 26 Mar 2025 11:00:09 -0400 Subject: [PATCH 7/7] contractions and ref --- source/reference/mongosync/mongosync-behavior.txt | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 5253c5e3a..14445f030 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -115,12 +115,13 @@ Chunk Distribution .. important:: - Even if the source cluster is balanced, ``mongosync`` does not + Even if the source cluster is balanced, ``mongosync`` doesn't ensure balance of the destination cluster. Because ``mongosync`` - does not support the execution of sharding operations during + doesn't support the execution of sharding operations during migration, you must wait until it is safe to accept writes to rebalance the destination cluster. See :ref:`sharding-balancing` - for guidance on how to rebalance the cluster and :ref:`c2c-sharded-limitations` + for guidance on how to rebalance the cluster and + :ref:`sharded cluster limitations ` for information on sharded cluster limitations in ``mongosync``. ``mongosync`` does not preserve chunk distribution from the source to