diff --git a/source/about-mongosync.txt b/source/about-mongosync.txt index 0258b9cf7..5165aa773 100644 --- a/source/about-mongosync.txt +++ b/source/about-mongosync.txt @@ -124,6 +124,20 @@ Finalize Sync To finalize the sync between the source and destination clusters, call the :ref:`commit ` endpoint. +.. note:: + + You must block writes to the source cluster before you begin the + the commit process. + + If you previously set ``enableUserWriteBlocking`` to ``true`` when + you used the :ref:`start ` endpoint, ``mongosync`` + automatically blocks writes on the source cluster when you use the + ``commit`` endpoint. + + If you did not set ``enableUserWriteBlocking`` to ``true``, run + :dbcommand:`setUserWriteBlockMode` on the source cluster to + block writes. + The ``commit`` endpoint starts the :ref:`COMMITTING ` state, which is when ``mongosync`` stops continuous sync between the source and destination clusters. diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index c6f3a2d1b..4001a5c2f 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -34,9 +34,11 @@ General Limitations are properly configured. - Other clients must not write to the destination cluster while ``mongosync`` is running. -- If write blocking is disabled, the client must :ref:`prevent writes - ` to the source cluster before starting the commit - process. +- If you want to start the :ref:`commit ` + process and you did not set ``enableUserWriteBlocking`` to ``true`` + when you used the :ref:`c2c-api-start` endpoint, you + must :ref:`prevent writes ` to the source cluster + before you start the commit process. - :ref:`system.* collections ` aren't replicated. - Documents that have dollar (``$``) prefixed field names aren't