From 84bc60a2d0a9b0efabc6b3ccbfd5645b60b0ef89 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Thu, 7 Nov 2024 13:38:57 -0500 Subject: [PATCH 1/6] DOCSP-45117-sharded-cluster-behavior --- source/reference/api/start.txt | 11 ++----- .../mongosync/mongosync-behavior.txt | 30 ++++++++++++++----- 2 files changed, 26 insertions(+), 15 deletions(-) diff --git a/source/reference/api/start.txt b/source/reference/api/start.txt index 0fa2ddf98..45e6df58a 100644 --- a/source/reference/api/start.txt +++ b/source/reference/api/start.txt @@ -359,14 +359,6 @@ State If the ``start`` request is successful, ``mongosync`` enters the ``RUNNING`` state. -Pre-Split Chunks -~~~~~~~~~~~~~~~~ - -When ``mongosync`` syncs to a sharded destination cluster, it pre-splits chunks -for sharded collections on the destination cluster. For each sharded collection, -``mongosync`` creates twice as many chunks as there are shards in the -destination cluster. - .. _c2c-shard-replica-sets: Shard Replica Sets @@ -379,6 +371,9 @@ collections. The ``sharding.shardingEntries`` array specifies the collections to shard. Collections that are not listed in this array replicate as unsharded. +For more information, see :ref:`Sharded Cluster Behavior +. + .. _c2c-supporting-index-behavior: Supporting Indexes diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 0b431ca67..4e14162ba 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -54,6 +54,8 @@ For information on available settings, see :ref:`Configuration `. Cluster and Collection Types ---------------------------- +.. _c2c-sharded-clusters: + Sharded Clusters ~~~~~~~~~~~~~~~~ @@ -68,6 +70,27 @@ Even if documents move between source shards during replication, guarantee on the destination cluster. For more information, see :ref:`c2c-sharded-clusters`. +Pre-Split Chunks +```````````````` + +When ``mongosync`` syncs to a sharded destination cluster, it pre-splits chunks +for sharded collections on the destination cluster. For each sharded collection, +``mongosync`` creates twice as many chunks as there are shards in the +destination cluster. + +Primary Shards +`````````````` + +When ``mongosync`` syncs to a sharded destination cluster, it assigns a +primary shard to each database by means of a round-robin. + +.. warning:: + + Running :dbcommand:`movePrimary` on the source or desintation cluster + during migration may result in a fatal error or require you to + restart the migration from scratch. For more information, see + :ref:`c2c-sharded-limitations`. + Multiple Clusters ~~~~~~~~~~~~~~~~~ @@ -162,13 +185,6 @@ snapshot of the source data. To learn more, see :ref:`c2c-behavior-consistency`. Otherwise, start a new continuous sync operation by using a new empty destination cluster. -Sharded Clusters -~~~~~~~~~~~~~~~~ - -When running continuous sync with sharded clusters, you must stop -:ref:`balancers ` on both the source and the destination -for the lifetime of the sync until commit. - Temporary Changes to Collection Characteristics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From e6386f8e3c58241010e828556a5ad4608f582868 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Thu, 7 Nov 2024 13:44:14 -0500 Subject: [PATCH 2/6] DOCSP-45117-sharded-cluster-behavior --- source/reference/api/start.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/reference/api/start.txt b/source/reference/api/start.txt index 45e6df58a..0ce96a092 100644 --- a/source/reference/api/start.txt +++ b/source/reference/api/start.txt @@ -372,7 +372,7 @@ The ``sharding.shardingEntries`` array specifies the collections to shard. Collections that are not listed in this array replicate as unsharded. For more information, see :ref:`Sharded Cluster Behavior -. +`. .. _c2c-supporting-index-behavior: From af3d70b4a0e906d3809208e278f09cc58d9bbfaf Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Thu, 7 Nov 2024 13:48:36 -0500 Subject: [PATCH 3/6] DOCSP-45117 fixing label --- source/reference/api/start.txt | 2 +- source/reference/mongosync/mongosync-behavior.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/api/start.txt b/source/reference/api/start.txt index 0ce96a092..4b693d5ba 100644 --- a/source/reference/api/start.txt +++ b/source/reference/api/start.txt @@ -372,7 +372,7 @@ The ``sharding.shardingEntries`` array specifies the collections to shard. Collections that are not listed in this array replicate as unsharded. For more information, see :ref:`Sharded Cluster Behavior -`. +`. .. _c2c-supporting-index-behavior: diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 4e14162ba..5bf03b687 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -54,7 +54,7 @@ For information on available settings, see :ref:`Configuration `. Cluster and Collection Types ---------------------------- -.. _c2c-sharded-clusters: +.. _c2c-sharded-cluster-behavior: Sharded Clusters ~~~~~~~~~~~~~~~~ From d285fb34b3bc3f5c5d9bf622d624f22d438c95f3 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Thu, 7 Nov 2024 14:20:03 -0500 Subject: [PATCH 4/6] DOCSP-45117 copy edits --- 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 5bf03b687..d567880a2 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -81,14 +81,14 @@ destination cluster. Primary Shards `````````````` -When ``mongosync`` syncs to a sharded destination cluster, it assigns a +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 desintation cluster during migration may result in a fatal error or require you to - restart the migration from scratch. For more information, see + restart the migration from the start. For more information, see :ref:`c2c-sharded-limitations`. Multiple Clusters From 7edfddc76edbc63c634408f8a532c0f0d02cf3eb Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 8 Nov 2024 12:24:23 -0500 Subject: [PATCH 5/6] DOCSP-45117 tech edit --- source/reference/mongosync/mongosync-behavior.txt | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index d567880a2..7e6c0a34c 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -60,15 +60,9 @@ Sharded Clusters ~~~~~~~~~~~~~~~~ {+c2c-product-name+} supports replication between sharded clusters. -Individual shards are replicated in parallel from the source cluster to -the destination cluster, however a :ref:`chunk migration -` or similar source update could move -documents to a new source shard during replication. - -Even if documents move between source shards during replication, -{+c2c-product-name+} maintains the :term:`eventual consistency` -guarantee on the destination cluster. For more information, see -:ref:`c2c-sharded-clusters`. +``mongosync`` replicates individual shards in parallel from the source +cluster to the destination cluster. However ``mongosync`` does not +preserve the source cluster's sharding configuration. Pre-Split Chunks ```````````````` From 405c10c82b21ce9462bd5b1b80a773f7db18225c Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 8 Nov 2024 13:44:54 -0500 Subject: [PATCH 6/6] DOCSP-45117 fixing underline --- 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 7e6c0a34c..a108af8fd 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -65,7 +65,7 @@ cluster to the destination cluster. However ``mongosync`` does not preserve the source cluster's sharding configuration. Pre-Split Chunks -```````````````` +'''''''''''''''' When ``mongosync`` syncs to a sharded destination cluster, it pre-splits chunks for sharded collections on the destination cluster. For each sharded collection, @@ -73,7 +73,7 @@ for sharded collections on the destination cluster. For each sharded collection, destination cluster. Primary Shards -`````````````` +'''''''''''''' When you sync to a sharded destination cluster, ``mongosync`` assigns a primary shard to each database by means of a round-robin.