Skip to content

Commit 7dd4506

Browse files
authored
DOCSP-46973-adds-large-destination-index-FAQ-v1.10-backport (579) (#592)
* DOCSP-46973-adds-large-destination-index-FAQ (#579) * DOCSP-46973-adds-large-destination-index-FAQ * Updates compact to use command role * Reverts previous commit * Update phrasing * Update to specify correlation * Update source/faq.txt Co-authored-by: ltran-mdb2 <[email protected]> * Update source/faq.txt Co-authored-by: ltran-mdb2 <[email protected]> * Responds to comments --------- Co-authored-by: ltran-mdb2 <[email protected]> (cherry picked from commit fcd8200) * Update start.txt * Update start.txt
1 parent a5c8a0e commit 7dd4506

File tree

2 files changed

+26
-0
lines changed

2 files changed

+26
-0
lines changed

source/faq.txt

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,30 @@ To learn more about permissable reads and writes during synchronization, see :re
4545
Index builds on the destination cluster are treated as writes
4646
while ``mongosync`` is syncing.
4747

48+
Why are the destination cluster indexes larger than the source cluster indexes?
49+
-------------------------------------------------------------------------------
50+
51+
The following factors may contribute to an increase in index size on destination
52+
clusters:
53+
54+
- ``mongosync`` inserts and removes data during a migration, which can cause data
55+
to be stored inefficiently on disk.
56+
- By default, ``mongosync`` builds indexes before copying data. ``mongosync``
57+
copies data in ``_id`` order. If an index is not correlated with ``_id``,
58+
the index size can become large. For more information, see the MongoDB Manual
59+
:ref:`FAQ: Indexes<faq-indexes-random-data-performance>` page.
60+
61+
Use the following methods to mitigate an increase in index size:
62+
63+
- Restart the migration with the ``buildIndexes``
64+
:ref:`parameter <c2c-api-start-params>` set to ``never``. When the migration
65+
finishes, manually build indexes on the destination cluster.
66+
- After the migration, perform a rolling :ref:`initial sync <replica-set-sync>`
67+
on the destination cluster.
68+
- After the migration, run :ref:`<compact>` on the destination cluster. This
69+
rebuilds indexes and releases unneeded disk space to the OS, but may impact
70+
cluster :ref:`performance <compact-perf>`.
71+
4872
Can ``mongosync`` run on its own hardware?
4973
------------------------------------------
5074

source/reference/api/start.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,8 @@ Request
5757

5858
POST /api/v1/start
5959

60+
.. _c2c-api-start-params:
61+
6062
Request Body Parameters
6163
~~~~~~~~~~~~~~~~~~~~~~~
6264

0 commit comments

Comments
 (0)