From f51583bae9728674b4da8f0505eed34f8c733430 Mon Sep 17 00:00:00 2001 From: "Kenneth P. J. Dyer" Date: Mon, 27 Jan 2025 15:50:27 -0600 Subject: [PATCH 1/6] DOCSP-46169 Verifier Guardrail Notice --- source/includes/fact-verifier-guardrail.rst | 1 + 1 file changed, 1 insertion(+) create mode 100644 source/includes/fact-verifier-guardrail.rst diff --git a/source/includes/fact-verifier-guardrail.rst b/source/includes/fact-verifier-guardrail.rst new file mode 100644 index 000000000..638c74c5c --- /dev/null +++ b/source/includes/fact-verifier-guardrail.rst @@ -0,0 +1 @@ +.. T From 05a68a3d4382e1149acc9d526d35187d9c7fbd40 Mon Sep 17 00:00:00 2001 From: "Kenneth P. J. Dyer" Date: Mon, 27 Jan 2025 15:59:01 -0600 Subject: [PATCH 2/6] Text adjustment --- source/includes/fact-verifier-guardrail.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/source/includes/fact-verifier-guardrail.rst b/source/includes/fact-verifier-guardrail.rst index 638c74c5c..b937d4ec4 100644 --- a/source/includes/fact-verifier-guardrail.rst +++ b/source/includes/fact-verifier-guardrail.rst @@ -1 +1,10 @@ -.. T +.. Verifier Guardrail Notice + +If you need to restart ``mongosync`` during a commit, such as if +``mongosync`` crashes in the ``WaitingForCommitComplete`` phase, +you must restart ``mongosync`` with the verifier disabled. + + + + + From b43eadf305cb9768eddcb85b43cd5a01aa076928 Mon Sep 17 00:00:00 2001 From: "Kenneth P. J. Dyer" Date: Mon, 27 Jan 2025 16:10:11 -0600 Subject: [PATCH 3/6] Adds text to existing include --- source/includes/fact-verification.rst | 9 +++++++++ source/includes/fact-verifier-guardrail.rst | 10 ---------- 2 files changed, 9 insertions(+), 10 deletions(-) delete mode 100644 source/includes/fact-verifier-guardrail.rst diff --git a/source/includes/fact-verification.rst b/source/includes/fact-verification.rst index 535ea63be..7791abc49 100644 --- a/source/includes/fact-verification.rst +++ b/source/includes/fact-verification.rst @@ -2,5 +2,14 @@ Before transferring your application load from the source cluster to the destination, check your data to ensure that the sync was successful. +.. note:: + + If ``mongosync`` stops while in the + ``WaitingForCommitComplete`` phase, such as due to memory + limitations, you must disable the verifier when you restart it. + + To disable the verifier, see the + :option:`--disableVerification` option. + For more information, see :ref:`c2c-verification`. diff --git a/source/includes/fact-verifier-guardrail.rst b/source/includes/fact-verifier-guardrail.rst deleted file mode 100644 index b937d4ec4..000000000 --- a/source/includes/fact-verifier-guardrail.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. Verifier Guardrail Notice - -If you need to restart ``mongosync`` during a commit, such as if -``mongosync`` crashes in the ``WaitingForCommitComplete`` phase, -you must restart ``mongosync`` with the verifier disabled. - - - - - From b632ed037d38b9feeac30e04219c8b285bae7969 Mon Sep 17 00:00:00 2001 From: "Kenneth P. J. Dyer" Date: Tue, 28 Jan 2025 11:30:41 -0600 Subject: [PATCH 4/6] Fixes per Ajay --- source/includes/fact-verification.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/source/includes/fact-verification.rst b/source/includes/fact-verification.rst index 7791abc49..2be6e95a1 100644 --- a/source/includes/fact-verification.rst +++ b/source/includes/fact-verification.rst @@ -4,12 +4,10 @@ destination, check your data to ensure that the sync was successful. .. note:: - If ``mongosync`` stops while in the - ``WaitingForCommitComplete`` phase, such as due to memory - limitations, you must disable the verifier when you restart it. - - To disable the verifier, see the - :option:`--disableVerification` option. + If``mongosync`` stops during a commit, before the + :ref:`/progress ` endpoint reports + ``canWrite: true``, you must restart the entire migration to + ensure that it's verified. For more information, see :ref:`c2c-verification`. From 7814f7f88a15701cc4d41af6d9bb5ffc39d99e12 Mon Sep 17 00:00:00 2001 From: "Kenneth P. J. Dyer" Date: Tue, 28 Jan 2025 11:35:38 -0600 Subject: [PATCH 5/6] Fixes build issue --- source/includes/fact-verification.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/fact-verification.rst b/source/includes/fact-verification.rst index 2be6e95a1..f6bea9da2 100644 --- a/source/includes/fact-verification.rst +++ b/source/includes/fact-verification.rst @@ -4,7 +4,7 @@ destination, check your data to ensure that the sync was successful. .. note:: - If``mongosync`` stops during a commit, before the + If ``mongosync`` stops during a commit, before the :ref:`/progress ` endpoint reports ``canWrite: true``, you must restart the entire migration to ensure that it's verified. From 3b78bec152c557062a2963548be446a82c6a9f17 Mon Sep 17 00:00:00 2001 From: "Kenneth P. J. Dyer" Date: Tue, 28 Jan 2025 11:39:10 -0600 Subject: [PATCH 6/6] Fixes text --- source/includes/fact-verification.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/fact-verification.rst b/source/includes/fact-verification.rst index f6bea9da2..0627dfe6e 100644 --- a/source/includes/fact-verification.rst +++ b/source/includes/fact-verification.rst @@ -4,7 +4,7 @@ destination, check your data to ensure that the sync was successful. .. note:: - If ``mongosync`` stops during a commit, before the + If ``mongosync`` stops during commit, before the :ref:`/progress ` endpoint reports ``canWrite: true``, you must restart the entire migration to ensure that it's verified.