From ebec64b44c2dcdbd7678ac4fa622c67e2dfbf4c9 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 1 Nov 2024 14:25:00 -0400 Subject: [PATCH 1/3] DOCSP-45041-adding-rolling-limitation-to-behavior --- source/includes/rolling-build-limitation.rst | 10 ++++++++++ source/reference/limitations.txt | 11 +---------- source/reference/mongosync/mongosync-behavior.txt | 5 +++++ 3 files changed, 16 insertions(+), 10 deletions(-) create mode 100644 source/includes/rolling-build-limitation.rst diff --git a/source/includes/rolling-build-limitation.rst b/source/includes/rolling-build-limitation.rst new file mode 100644 index 000000000..ee28e725e --- /dev/null +++ b/source/includes/rolling-build-limitation.rst @@ -0,0 +1,10 @@ +``mongosync`` does not support :ref:`rolling index builds +` during migration. To avoid building +indexes in a rolling fashion during migration, use one of the following +methods to ensure that your destination indexes match your source +indexes: + +- Build the index on the source before migration. +- Build the index on the source during migration with a non-rolling + index build. +- Build the index on the destination after migration. \ No newline at end of file diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index 438843733..f0c483ceb 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -175,13 +175,4 @@ System Collections Rolling Index Builds -------------------- -``mongosync`` does not support :ref:`rolling index builds -` during migration. To avoid building -indexes in a rolling fashion during migration, use one of the following -methods to ensure that your destination indexes match your source -indexes: - -- Build the index on the source before migration. -- Build the index on the source during migration with a non-rolling - index build. -- Build the index on the destination after migration. \ No newline at end of file +.. include:: /includes/collections/rolling-build-limitation.rst \ No newline at end of file diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 1e8a8a54a..4203306fc 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -208,6 +208,11 @@ synchronization. The original values are restored during the commit process. - In some cases, synchronization may create dummy indexes on the destination to support writes on sharded or collated collections. +Rolling Index Builds +~~~~~~~~~~~~~~~~~~~~ + +.. include:: /includes/collections/rolling-build-limitation.rst + Destination Clusters -------------------- From a9f07e7b026e30f294c6316dc27caa43f2439aac Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Fri, 1 Nov 2024 14:34:16 -0400 Subject: [PATCH 2/3] DOCSP-45041-adding-rolling-limitation-to-behavior --- source/reference/limitations.txt | 2 +- source/reference/mongosync/mongosync-behavior.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/reference/limitations.txt b/source/reference/limitations.txt index f0c483ceb..c6f3a2d1b 100644 --- a/source/reference/limitations.txt +++ b/source/reference/limitations.txt @@ -175,4 +175,4 @@ System Collections Rolling Index Builds -------------------- -.. include:: /includes/collections/rolling-build-limitation.rst \ No newline at end of file +.. include:: /includes/rolling-build-limitation.rst \ No newline at end of file diff --git a/source/reference/mongosync/mongosync-behavior.txt b/source/reference/mongosync/mongosync-behavior.txt index 4203306fc..0b431ca67 100644 --- a/source/reference/mongosync/mongosync-behavior.txt +++ b/source/reference/mongosync/mongosync-behavior.txt @@ -211,7 +211,7 @@ synchronization. The original values are restored during the commit process. Rolling Index Builds ~~~~~~~~~~~~~~~~~~~~ -.. include:: /includes/collections/rolling-build-limitation.rst +.. include:: /includes/rolling-build-limitation.rst Destination Clusters -------------------- From ba6781743ab3ac30efe3a76458cc4ddba7f3bc97 Mon Sep 17 00:00:00 2001 From: Lauren Tran Date: Mon, 4 Nov 2024 12:48:41 -0500 Subject: [PATCH 3/3] DOCSP-45041 default index link --- source/includes/rolling-build-limitation.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/includes/rolling-build-limitation.rst b/source/includes/rolling-build-limitation.rst index ee28e725e..a73cb54f6 100644 --- a/source/includes/rolling-build-limitation.rst +++ b/source/includes/rolling-build-limitation.rst @@ -5,6 +5,6 @@ methods to ensure that your destination indexes match your source indexes: - Build the index on the source before migration. -- Build the index on the source during migration with a non-rolling - index build. +- Build the index on the source during migration with a :ref:`default + index build `. - Build the index on the destination after migration. \ No newline at end of file