From 0d1bc99267e06792e37fb742bd1708cbd875b6db Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Thu, 14 Dec 2023 15:53:10 -0500 Subject: [PATCH 01/10] DOCSP-29155 adding behavior info to mongosync --- source/reference/mongosync.txt | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 4659c2351..4dfa1312d 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -296,6 +296,24 @@ error occurs, the ``mongosync`` log may contain the word "error' but ``mongosync`` is still able to complete the sync. In the case that a sync does not complete, ``mongosync`` writes a fatal log entry. +UUIDs +~~~~~ + +``mongosync`` creates new universally unique identifiers (UUIDs) for collections +on the destination cluster. There is no relationship between UUIDs on +the source cluster and the destination cluster. If applicates have +hard-coded collection UUIDs (which MongoDB does not reccomend), +``mongosync`` requires additional updating to work with a migrated +cluster. + +Sorting +~~~~~~~ + +``mongosync`` creates a new natural (without any sort method specified) +order on the desination cluster. If applications depend on document +order without defining a sort, they may require additional updateing to +work with a migrated cluster. + .. _c2c-mongosync-examples: Examples From f92db35a6ba01074d666d258638fed5effbd1f32 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Mon, 18 Dec 2023 15:23:22 -0500 Subject: [PATCH 02/10] DOCSP-29155 adding sorting and uuids to mongosync page --- source/reference/mongosync.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 4dfa1312d..f7cb15b14 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -299,10 +299,10 @@ sync does not complete, ``mongosync`` writes a fatal log entry. UUIDs ~~~~~ -``mongosync`` creates new universally unique identifiers (UUIDs) for collections -on the destination cluster. There is no relationship between UUIDs on -the source cluster and the destination cluster. If applicates have -hard-coded collection UUIDs (which MongoDB does not reccomend), +``mongosync`` creates new universally unique identifiers (UUIDs) for +collections on the destination cluster. There is no relationship between +UUIDs on the source cluster and the destination cluster. If applications +have hard-coded collection UUIDs (which MongoDB does not reccomend), ``mongosync`` requires additional updating to work with a migrated cluster. @@ -311,7 +311,7 @@ Sorting ``mongosync`` creates a new natural (without any sort method specified) order on the desination cluster. If applications depend on document -order without defining a sort, they may require additional updateing to +order without a defined sort method, they may require additional updateing to work with a migrated cluster. .. _c2c-mongosync-examples: From 12c927f18228864ca91d0d76e0c805743926e742 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Mon, 18 Dec 2023 15:28:45 -0500 Subject: [PATCH 03/10] DOCSP-29155 adding sorting and uuids to mongosync page --- source/reference/mongosync.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index f7cb15b14..1dd1d07cb 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -302,7 +302,7 @@ UUIDs ``mongosync`` creates new universally unique identifiers (UUIDs) for collections on the destination cluster. There is no relationship between UUIDs on the source cluster and the destination cluster. If applications -have hard-coded collection UUIDs (which MongoDB does not reccomend), +contain hard-coded collection UUIDs (which MongoDB does not recommend), ``mongosync`` requires additional updating to work with a migrated cluster. @@ -310,8 +310,8 @@ Sorting ~~~~~~~ ``mongosync`` creates a new natural (without any sort method specified) -order on the desination cluster. If applications depend on document -order without a defined sort method, they may require additional updateing to +order on the destination cluster. If applications depend on document +order without a defined sort method, they may require additional updating to work with a migrated cluster. .. _c2c-mongosync-examples: From 5490dd9288a7367864d17cf13b6650fa7edd6ecf Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Wed, 20 Dec 2023 10:11:14 -0500 Subject: [PATCH 04/10] DOCSP-29155 copy edits --- source/reference/mongosync.txt | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 1dd1d07cb..c2bab7577 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -299,20 +299,21 @@ sync does not complete, ``mongosync`` writes a fatal log entry. UUIDs ~~~~~ -``mongosync`` creates new universally unique identifiers (UUIDs) for -collections on the destination cluster. There is no relationship between -UUIDs on the source cluster and the destination cluster. If applications -contain hard-coded collection UUIDs (which MongoDB does not recommend), -``mongosync`` requires additional updating to work with a migrated -cluster. +``mongosync`` creates new :abbr:`UUIDs (universally unique identifiers)` +for collections on the destination cluster. There is no relationship +between UUIDs on the source cluster and the destination cluster. If +applications contain hard-coded UUIDs (which MongoDB does not +recommend), you may need to update the application's UUIDs before the +application works properly with a migrated cluster. Sorting ~~~~~~~ -``mongosync`` creates a new natural (without any sort method specified) -order on the destination cluster. If applications depend on document -order without a defined sort method, they may require additional updating to -work with a migrated cluster. +``mongosync`` creates a new natural order (without any sort method +specified) on the destination cluster. If applications depend on +document order but don't have a defined sort method, you may need to +update the application to specify the expected sort order before the +application works properly with the migrated cluster. .. _c2c-mongosync-examples: From b4b8ab81ace8e00c4ca50c33b0900130d11131d4 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Thu, 21 Dec 2023 11:36:29 -0500 Subject: [PATCH 05/10] DOCSP-29155 copy edit --- source/reference/mongosync.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index c2bab7577..a3b6ef7c1 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -303,8 +303,8 @@ UUIDs for collections on the destination cluster. There is no relationship between UUIDs on the source cluster and the destination cluster. If applications contain hard-coded UUIDs (which MongoDB does not -recommend), you may need to update the application's UUIDs before the -application works properly with a migrated cluster. +recommend), you may need to update the application before it works +properly with a migrated cluster. Sorting ~~~~~~~ From 9de5f6ceeb80826912acea2a226b1e7c55573b12 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 5 Jan 2024 12:02:46 -0500 Subject: [PATCH 06/10] DOCSP-29155 tech edits --- source/reference/mongosync.txt | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index a3b6ef7c1..d9eb23ddd 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -299,21 +299,22 @@ sync does not complete, ``mongosync`` writes a fatal log entry. UUIDs ~~~~~ -``mongosync`` creates new :abbr:`UUIDs (universally unique identifiers)` -for collections on the destination cluster. There is no relationship -between UUIDs on the source cluster and the destination cluster. If -applications contain hard-coded UUIDs (which MongoDB does not -recommend), you may need to update the application before it works -properly with a migrated cluster. +``mongosync`` creates collections with new :abbr:`UUIDs (universally +unique identifiers)` for collections on the destination cluster. There +is no relationship between UUIDs on the source cluster and the +destination cluster. If applications contain hard-coded UUIDs (which +MongoDB does not recommend), you may need to update the application +before it works properly with a migrated cluster. Sorting ~~~~~~~ -``mongosync`` creates a new natural order (without any sort method -specified) on the destination cluster. If applications depend on -document order but don't have a defined sort method, you may need to -update the application to specify the expected sort order before the -application works properly with the migrated cluster. +``mongosync`` inserts documents on the destination cluster in an +undefined order. Natural sort order from the source cluster is not +preserved on the destination cluster. If applications depend on document +order but don't have a defined sort method, you may need to update those +application to specify the expected sort order before the application +work properly with the migrated cluster. .. _c2c-mongosync-examples: From f2ed4e0218fdaccb2234550c178614f703828678 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 5 Jan 2024 12:25:10 -0500 Subject: [PATCH 07/10] DOCSP-29155 tech edits --- source/reference/mongosync.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index d9eb23ddd..7842f5878 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -300,11 +300,11 @@ UUIDs ~~~~~ ``mongosync`` creates collections with new :abbr:`UUIDs (universally -unique identifiers)` for collections on the destination cluster. There -is no relationship between UUIDs on the source cluster and the -destination cluster. If applications contain hard-coded UUIDs (which -MongoDB does not recommend), you may need to update the application -before it works properly with a migrated cluster. +unique identifiers)` on the destination cluster. There is no +relationship between UUIDs on the source cluster and the destination +cluster. If applications contain hard-coded UUIDs (which MongoDB does +not recommend), you may need to update the application before it works +properly with a migrated cluster. Sorting ~~~~~~~ @@ -313,7 +313,7 @@ Sorting undefined order. Natural sort order from the source cluster is not preserved on the destination cluster. If applications depend on document order but don't have a defined sort method, you may need to update those -application to specify the expected sort order before the application +applications to specify the expected sort order before the applications work properly with the migrated cluster. .. _c2c-mongosync-examples: From c3a786f7f57549870dd3c4438214a7edd716783a Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 5 Jan 2024 12:31:11 -0500 Subject: [PATCH 08/10] DOCSP-29155 tech edits --- source/reference/mongosync.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 7842f5878..8e19a00a7 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -303,8 +303,8 @@ UUIDs unique identifiers)` on the destination cluster. There is no relationship between UUIDs on the source cluster and the destination cluster. If applications contain hard-coded UUIDs (which MongoDB does -not recommend), you may need to update the application before it works -properly with a migrated cluster. +not recommend), you may need to update those applications before they +work properly with the migrated cluster. Sorting ~~~~~~~ From b25f74cb39e4395c0bcff80e84f13b5485969c47 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 5 Jan 2024 12:33:33 -0500 Subject: [PATCH 09/10] DOCSP-29155 tech edits --- source/reference/mongosync.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 8e19a00a7..3cb5442fe 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -310,11 +310,11 @@ Sorting ~~~~~~~ ``mongosync`` inserts documents on the destination cluster in an -undefined order. Natural sort order from the source cluster is not -preserved on the destination cluster. If applications depend on document -order but don't have a defined sort method, you may need to update those -applications to specify the expected sort order before the applications -work properly with the migrated cluster. +undefined order. ``mongosync`` does not preserve natural sort order from +the source cluster on the destination cluster. If applications depend on +document order but don't have a defined sort method, you may need to +update those applications to specify the expected sort order before the +applications work properly with the migrated cluster. .. _c2c-mongosync-examples: From 8ffcd92c09e40a51428ea75118f2d45cfa22cc08 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Tue, 9 Jan 2024 13:52:55 -0500 Subject: [PATCH 10/10] DOCSP-29155 tech edit --- source/reference/mongosync.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt index 3cb5442fe..21b929c01 100644 --- a/source/reference/mongosync.txt +++ b/source/reference/mongosync.txt @@ -310,11 +310,11 @@ Sorting ~~~~~~~ ``mongosync`` inserts documents on the destination cluster in an -undefined order. ``mongosync`` does not preserve natural sort order from -the source cluster on the destination cluster. If applications depend on -document order but don't have a defined sort method, you may need to -update those applications to specify the expected sort order before the -applications work properly with the migrated cluster. +undefined order which does not preserve natural sort order from the +source cluster. If applications depend on document order but don't have +a defined sort method, you may need to update those applications to +specify the expected sort order before the applications work properly +with the migrated cluster. .. _c2c-mongosync-examples: