merge (#80)

Author: kennethdyer

source/multiple-mongosyncs.txt

@@ -100,16 +100,6 @@ To configure multiple ``mongosync`` instances:
          A single host server can run multiple ``mongosync`` instances. To
          improve performance, run ``mongosync`` on multiple host servers.
 
-      Each ``mongosync`` instance:
-
-      - Connects to the same ``mongos`` instance in the source cluster.
-      - Connects to the same ``mongos`` instance in the destination
-        cluster.
-      - Connects to a single shard in the source cluster.
-      - Specifies a unique port to use for during synchronization.
-        Consider designating a range of ports to simplify scripting
-        {+c2c-product-name+} operations.
-
       Run the first ``mongosync`` instance:
 
       .. code-block:: javascript
@@ -119,6 +109,11 @@ To configure multiple ``mongosync`` instances:
            --cluster1 "mongodb://user:password@cluster1host:27500" \
            --id shard01 --port 27601
 
+      When running multiple ``mongosync`` instances, the number of instances
+      must equal the number of shards.  Each ``mongosync`` instance must be
+      started with the :option:`--id` option or :setting:`id` setting to
+      specify the shard it replicates.
+
       Run a new ``mongosync`` instance for each shard in the source cluster.
       Edit the ``--id`` and ``--port`` fields for each additional
       ``mongosync`` instance.
@@ -131,6 +126,21 @@ To configure multiple ``mongosync`` instances:
            --cluster1 "mongodb://user:password@cluster1host:27500" \
            --id shard02 --port 27602
 
+      The connection strings for the :option:`--cluster0` and 
+      :option:`--cluster1` options should point to ``mongos`` instances.
+      In the example, they use the same ``mongos`` instance.
+
+      Each ``mongosync`` instance:
+
+      - Connects to ``mongos`` instances in the source cluster.
+      - Connects to ``mongos`` instances in the destination cluster.
+      - Replicates a single shard from the source cluster, 
+        identified by the :option:`--id` option.
+      - Specifies a unique port to use during synchronization.
+        Consider designating a range of ports to simplify scripting
+        {+c2c-product-name+} operations.
+
+
 .. _c2c-sharded-start:
 
 Start Multiple ``mongosync`` Instances