@@ -54,19 +54,36 @@ For information on available settings, see :ref:`Configuration <c2c-config>`.
5454Cluster and Collection Types
5555----------------------------
5656
57+ .. _c2c-sharded-cluster-behavior:
58+
5759Sharded Clusters
5860~~~~~~~~~~~~~~~~
5961
6062{+c2c-product-name+} supports replication between sharded clusters.
61- Individual shards are replicated in parallel from the source cluster to
62- the destination cluster, however a :ref:`chunk migration
63- <sharding-chunk-migration>` or similar source update could move
64- documents to a new source shard during replication.
63+ ``mongosync`` replicates individual shards in parallel from the source
64+ cluster to the destination cluster. However ``mongosync`` does not
65+ preserve the source cluster's sharding configuration.
66+
67+ Pre-Split Chunks
68+ ''''''''''''''''
69+
70+ When ``mongosync`` syncs to a sharded destination cluster, it pre-splits chunks
71+ for sharded collections on the destination cluster. For each sharded collection,
72+ ``mongosync`` creates twice as many chunks as there are shards in the
73+ destination cluster.
74+
75+ Primary Shards
76+ ''''''''''''''
6577
66- Even if documents move between source shards during replication,
67- {+c2c-product-name+} maintains the :term:`eventual consistency`
68- guarantee on the destination cluster. For more information, see
69- :ref:`c2c-sharded-clusters`.
78+ When you sync to a sharded destination cluster, ``mongosync`` assigns a
79+ primary shard to each database by means of a round-robin.
80+
81+ .. warning::
82+
83+ Running :dbcommand:`movePrimary` on the source or desintation cluster
84+ during migration may result in a fatal error or require you to
85+ restart the migration from the start. For more information, see
86+ :ref:`c2c-sharded-limitations`.
7087
7188Multiple Clusters
7289~~~~~~~~~~~~~~~~~
@@ -155,13 +172,6 @@ snapshot of the source data. To learn more, see :ref:`c2c-behavior-consistency`.
155172 Otherwise, start a new continuous sync operation by using a new empty
156173 destination cluster.
157174
158- Sharded Clusters
159- ~~~~~~~~~~~~~~~~
160-
161- When running continuous sync with sharded clusters, you must stop
162- :ref:`balancers <sharding-balancing>` on both the source and the destination
163- for the lifetime of the sync until commit.
164-
165175Temporary Changes to Collection Characteristics
166176~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
167177
0 commit comments