From 480ca7a5e9af5fe50ffc4409cb2920de69ba3238 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 10 Jul 2024 12:01:23 -0700 Subject: [PATCH 1/6] DOCSP-40138-Mongosync-Delay-After-Resume-Restart --- source/faq.txt | 2 ++ source/includes/fact-restart-resume-delay.rst | 6 ++++++ source/reference/api/resume.txt | 6 +++--- source/reference/mongosync-states.txt | 2 ++ source/release-notes/1.7.txt | 2 ++ 5 files changed, 15 insertions(+), 3 deletions(-) create mode 100644 source/includes/fact-restart-resume-delay.rst diff --git a/source/faq.txt b/source/faq.txt index 3becd22d0..dd6c15db7 100644 --- a/source/faq.txt +++ b/source/faq.txt @@ -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? ------------------------------------------------------------- diff --git a/source/includes/fact-restart-resume-delay.rst b/source/includes/fact-restart-resume-delay.rst new file mode 100644 index 000000000..9b5128a17 --- /dev/null +++ b/source/includes/fact-restart-resume-delay.rst @@ -0,0 +1,6 @@ +.. note:: + + Starting in ``mongosync`` 1.7.3, ``mongosync`` can take at least two minutes + to respond when you resume or restart a sync operation. This means that + until ``mongosync`` responds, any calls to the :ref:`c2c-api-progress` + endpoint might fail. diff --git a/source/reference/api/resume.txt b/source/reference/api/resume.txt index 334c0b0fd..c9c585a49 100644 --- a/source/reference/api/resume.txt +++ b/source/reference/api/resume.txt @@ -71,12 +71,12 @@ Response Behavior -------- +- When you send a ``resume`` request, ``mongosync`` might take at least two + minutes before resuming the migration. + - 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 ~~~~~~~~~~~~~~~~~~~ diff --git a/source/reference/mongosync-states.txt b/source/reference/mongosync-states.txt index 0b69d69f9..174fbe49b 100644 --- a/source/reference/mongosync-states.txt +++ b/source/reference/mongosync-states.txt @@ -26,6 +26,8 @@ To view the current state of ``mongosync``, use the :ref:`/progress `. endpoint. The :ref:`/progress ` endpoint returns the state in the ``state`` field. +.. include:: /includes/fact-restart-resume-delay.rst + .. _c2c-states-descriptions: State Descriptions diff --git a/source/release-notes/1.7.txt b/source/release-notes/1.7.txt index 34113e303..57161283b 100644 --- a/source/release-notes/1.7.txt +++ b/source/release-notes/1.7.txt @@ -141,6 +141,8 @@ Issues Fixed: Other Changes: +- Adds a two minute delay when restarting and resuming sync operations. + - Disables the Oplog Rollover Resilience mechanism. - Live upgrade to mongosync 1.7.2 is not allowed. From dced6e10923948036a8dd792acf8997480c4b693 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 10 Jul 2024 12:05:19 -0700 Subject: [PATCH 2/6] add 1.8 to toc --- source/release-notes.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/source/release-notes.txt b/source/release-notes.txt index 5047706f5..4ffade3d7 100644 --- a/source/release-notes.txt +++ b/source/release-notes.txt @@ -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 From a50c0a2082b2b6d522e2c32ace4091144bc9050a Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 10 Jul 2024 12:06:12 -0700 Subject: [PATCH 3/6] * --- source/release-notes/1.7.txt | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/release-notes/1.7.txt b/source/release-notes/1.7.txt index 57161283b..83c88ca65 100644 --- a/source/release-notes/1.7.txt +++ b/source/release-notes/1.7.txt @@ -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 @@ -141,8 +145,6 @@ Issues Fixed: Other Changes: -- Adds a two minute delay when restarting and resuming sync operations. - - Disables the Oplog Rollover Resilience mechanism. - Live upgrade to mongosync 1.7.2 is not allowed. From 978143c5eeba5cd1d0310aa2894683570737113d Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 10 Jul 2024 12:12:55 -0700 Subject: [PATCH 4/6] * --- source/includes/fact-restart-resume-delay.rst | 2 +- source/reference/api/progress.txt | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/source/includes/fact-restart-resume-delay.rst b/source/includes/fact-restart-resume-delay.rst index 9b5128a17..b409ea452 100644 --- a/source/includes/fact-restart-resume-delay.rst +++ b/source/includes/fact-restart-resume-delay.rst @@ -1,5 +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. This means that until ``mongosync`` responds, any calls to the :ref:`c2c-api-progress` diff --git a/source/reference/api/progress.txt b/source/reference/api/progress.txt index 8e53cdc7d..00406f5db 100644 --- a/source/reference/api/progress.txt +++ b/source/reference/api/progress.txt @@ -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 ~~~~~~~~~~~~~~~~~~~ From 6a8b8cc352b733b36ea2de2b9ed83e191113ae0d Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Wed, 10 Jul 2024 13:20:42 -0700 Subject: [PATCH 5/6] JA feedback --- source/includes/fact-restart-resume-delay.rst | 5 ++--- source/reference/api/resume.txt | 3 ++- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/source/includes/fact-restart-resume-delay.rst b/source/includes/fact-restart-resume-delay.rst index b409ea452..21086f1b5 100644 --- a/source/includes/fact-restart-resume-delay.rst +++ b/source/includes/fact-restart-resume-delay.rst @@ -1,6 +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. This means that - until ``mongosync`` responds, any calls to the :ref:`c2c-api-progress` - endpoint might fail. + to respond when you resume or restart a sync operation. During this time, + any calls to the :ref:`c2c-api-progress` endpoint might fail. diff --git a/source/reference/api/resume.txt b/source/reference/api/resume.txt index c9c585a49..32e63177a 100644 --- a/source/reference/api/resume.txt +++ b/source/reference/api/resume.txt @@ -72,7 +72,8 @@ Behavior -------- - When you send a ``resume`` request, ``mongosync`` might take at least two - minutes before resuming the migration. + 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. From d42bb67bbdb600fff70d1942ffa2c8f7639bc961 Mon Sep 17 00:00:00 2001 From: Alison Huh Date: Mon, 15 Jul 2024 10:57:51 -0400 Subject: [PATCH 6/6] add retry bit --- source/includes/fact-restart-resume-delay.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/includes/fact-restart-resume-delay.rst b/source/includes/fact-restart-resume-delay.rst index 21086f1b5..ddf0a0ff1 100644 --- a/source/includes/fact-restart-resume-delay.rst +++ b/source/includes/fact-restart-resume-delay.rst @@ -2,4 +2,5 @@ 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. + any calls to the :ref:`c2c-api-progress` endpoint might fail. If a + ``progress`` call fails, it is safe to retry.