Skip to content

DOCSP-40138-Mongosync-Delay-After-Resume-Restart #343

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions source/faq.txt
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,8 @@ available again, restart the ``mongosync`` process with the same
parameters. ``mongosync`` resumes the operation from where it stopped
when ``mongosync`` became unavailable.

.. include:: /includes/fact-restart-resume-delay.rst

Can the source or destination be a replica set with arbiters?
-------------------------------------------------------------

Expand Down
5 changes: 5 additions & 0 deletions source/includes/fact-restart-resume-delay.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
.. note::

Starting in ``mongosync`` 1.7.3, ``mongosync`` can take at least two minutes
to respond when you resume or restart a sync operation. During this time,
any calls to the :ref:`c2c-api-progress` endpoint might fail.
2 changes: 2 additions & 0 deletions source/reference/api/progress.txt
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,8 @@ Behavior

- The endpoint does not auto-refresh. To get updated status, call the
``progress`` endpoint again.

.. include:: /includes/fact-restart-resume-delay.rst

Endpoint Protection
~~~~~~~~~~~~~~~~~~~
Expand Down
7 changes: 4 additions & 3 deletions source/reference/api/resume.txt
Original file line number Diff line number Diff line change
Expand Up @@ -71,12 +71,13 @@ Response
Behavior
--------

- When you send a ``resume`` request, ``mongosync`` might take at least two
minutes before resuming the migration. To see if the migration resumed, you
can call the :ref:`c2c-api-progress` endpoint.

- If the ``resume`` request is successful, ``mongosync`` enters the
``RUNNING`` state.

- When you send a ``resume`` request, there may be a delay of up to a
few minutes before ``mongosync`` resumes the migration.

Endpoint Protection
~~~~~~~~~~~~~~~~~~~

Expand Down
2 changes: 2 additions & 0 deletions source/reference/mongosync-states.txt
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ To view the current state of ``mongosync``, use the :ref:`/progress
<c2c-api-progress>`. endpoint. The :ref:`/progress <c2c-api-progress>`
endpoint returns the state in the ``state`` field.

.. include:: /includes/fact-restart-resume-delay.rst

.. _c2c-states-descriptions:

State Descriptions
Expand Down
1 change: 1 addition & 0 deletions source/release-notes.txt
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ Previous Rapid Releases
.. toctree::
:titlesonly:

/release-notes/1.8
/release-notes/1.7
/release-notes/1.6
/release-notes/1.5
Expand Down
4 changes: 4 additions & 0 deletions source/release-notes/1.7.txt
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,10 @@ Issues Fixed:
events when mongosync is interrupted and resumed. This is an unlikely
edge case.

Other Changes:

- Adds a two minute delay when restarting and resuming sync operations.

Limitations:

- You must stop the balancer on both the source and destination sharded
Expand Down