File tree Expand file tree Collapse file tree 1 file changed +22
-0
lines changed Expand file tree Collapse file tree 1 file changed +22
-0
lines changed Original file line number Diff line number Diff line change @@ -140,6 +140,28 @@ These logs do not indicate that ``mongosync`` is failing or corrupting
140
140
data. If a fatal error occurs, ``mongosync`` stops the sync and writes a
141
141
fatal log entry.
142
142
143
+ What if I see a lot of duplicate key errors in the logs?
144
+ --------------------------------------------------------
145
+
146
+ Duplicate key errors are a normal part of the sync process. These errors can
147
+ occur if:
148
+
149
+ - You insert a document on the source cluster after ``mongosync`` starts.
150
+ ``mongosync`` may directly copy the document and redundantly apply the insert
151
+ change event for the document later.
152
+ - You stop and resume ``mongosync``. This can lead to duplicate insertions when
153
+ ``mongosync`` restarts.
154
+ - ``mongosync`` encounters a transient error and reattempts an insertion that
155
+ may have already succeeded.
156
+
157
+ What should I do if mongosync returns a fatal error?
158
+ ----------------------------------------------------
159
+
160
+ A fatal error indicates a problem that must be corrected and requires the
161
+ migration to be restarted. After addressing the error, delete all migrated
162
+ data on the destination cluster, including the ``mongosync_reserved_for_internal_use``
163
+ database. Then, relaunch ``mongosync`` and start a new migration.
164
+
143
165
Does ``mongosync`` Support TTL Indexes?
144
166
----------------------------------------
145
167
You can’t perform that action at this time.
0 commit comments