diff --git a/source/includes/rolling-build-limitation.rst b/source/includes/rolling-build-limitation.rst new file mode 100644 index 000000000..a73cb54f6 --- /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 :ref:`default + 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..c6f3a2d1b 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/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..0b431ca67 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/rolling-build-limitation.rst + Destination Clusters --------------------