Merge v0.9.0 into v1.0

Bring v0.9.0 and v1.0 back into sync

Author: jeff-allen-mongo

snooty.toml

@@ -17,6 +17,7 @@ toc_landing_pages = ["/quickstart",
                      "reference/reference",
                      "/connecting",
                      "/using-mongosync",
+                     "/multiple-mongosyncs",
                      "/release-notes/release-notes",
                      "/faq"
                     ]

source/faq.txt

@@ -56,9 +56,21 @@ Which connection string options does ``mongosync`` allow?
 ---------------------------------------------------------
 
 ``mongosync`` requires :ref:`readConcern: "majority" <read-concern>`
-and :ref:`writeConcern: "majority" <write-concern>`. ``mongosync`` 
-overwrites any other ``readConcern`` or ``writeConcern`` and uses
-``"majority"`` instead.
+and :ref:`writeConcern: "majority" <write-concern>`. 
+
+If the ``readConcern`` is not ``majority``, ``mongosync`` returns an
+error:
+
+.. code-block:: shell
+
+   Invalid URI option, read concern must be majority
+
+If the ``writeConcern`` is not ``majority``, ``mongosync`` returns an
+error:
+
+.. code-block:: shell
+
+   Invalid URI option, write concern must be majority
 
 ``mongosync`` accepts all other :ref:`connection string options
 <mongodb-uri>`.

source/includes/api/requests/start-reversible.sh

@@ -1,4 +1,4 @@
-curl localhost:27182/api/v1/start -XPOST
+curl localhost:27182/api/v1/start -XPOST \
 --data '
    {
       "source": "cluster0",

source/includes/fact-write-blocking-requirement.rst

@@ -0,0 +1,3 @@
+To set ``enableUserWriteBlocking``, the ``mongosync`` user must have a
+role that includes the ``setUserWriteBlockMode`` and
+``bypassWriteBlockingMode`` ActionTypes.

source/includes/opts/cluster0.rst

@@ -0,0 +1,10 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+Sets the :ref:`connection URI <mongodb-uri>` for the first cluster.
+The first cluster can serve as either the source or the destination
+in the sync process. Designate the source and destination clusters
+in the call to the :ref:`c2c-api-start` API endpoint.
+
+For more information on connecting ``mongosync``, see
+:ref:`Connections <c2c-connecting>`.

source/includes/opts/cluster1.rst

@@ -0,0 +1,10 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+Sets the :ref:`connection URI <mongodb-uri>` for the second cluster.
+The second cluster can serve as either the source or the destination
+in the sync process. Designate the source and destination clusters
+in the call to the :ref:`c2c-api-start` API endpoint.
+
+For more information on connecting ``mongosync``, see
+:ref:`Connections <c2c-connecting>`.

source/includes/opts/id.rst

@@ -0,0 +1,10 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+Sets an identifier for the ``mongosync`` instance.
+
+Use this |opt-term| when running multiple instances of ``mongosync`` on a sharded
+cluster, to synchronize the shards individually.
+
+The identifier value for this |opt-term| must correspond to the shard ID of the
+shard it syncs.  To find the shard ID, use the :dbcommand:`listShards` command.

source/includes/opts/logPath.rst

@@ -0,0 +1,5 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+Sets the path to the log directory. {+c2c-product-name+} writes logs
+to files in this directory.

source/includes/opts/port.rst

@@ -0,0 +1,7 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+*Default*: ``27182``
+
+Sets the port used by the HTTP server for the {+c2c-product-name+}
+HTTP API.

source/includes/opts/verbosity.rst

@@ -0,0 +1,18 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+*Default*: ``INFO``
+
+Sets the verbosity level to use in log messages.
+{+c2c-product-name+} logs all messages at the specified level and
+any messages at lower levels.
+
+The |verbosity-opt| |verbosity-opt-type| supports the following values:
+
+- ``TRACE``
+- ``DEBUG``
+- ``INFO``
+- ``WARN``
+- ``ERROR``
+- ``FATAL``
+- ``PANIC``

source/index.txt

@@ -38,6 +38,7 @@ common questions users have asked about ``mongosync``.
    /quickstart
    /installation
    /connecting
+   /multiple-mongosyncs
    /reference
    /release-notes
    /faq