Skip to content

Commit b0512fe

Browse files
author
Dave Cuthbert
authored
DOCSP-30223 1.4.0 release notes (#129)
* DOCSP-30223 Release Notes 1.4.0 * Review Feedback * Link experiment * Memory improvement * Review feedback * additional details
1 parent 7897df7 commit b0512fe

File tree

7 files changed

+77
-24
lines changed

7 files changed

+77
-24
lines changed

‎source/reference.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,5 +17,6 @@ Reference
1717
/reference/limitations
1818
/reference/logging
1919
/reference/permissions
20+
/reference/telemetry
2021
/reference/versioning
2122

‎source/release-notes.txt

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,9 @@ Release Notes
88
.. toctree::
99
:titlesonly:
1010

11-
/release-notes/0.9
12-
/release-notes/1.0
13-
/release-notes/1.1
14-
/release-notes/1.2
11+
/release-notes/1.4
1512
/release-notes/1.3
16-
17-
13+
/release-notes/1.2
14+
/release-notes/1.1
15+
/release-notes/1.0
16+
/release-notes/0.9

‎source/release-notes/1.0.txt

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,7 @@ Release Notes for ``mongosync`` 1.0
1212
:depth: 1
1313
:class: singlecol
1414

15-
.. note::
16-
17-
``mongosync`` 1.0 Released July 22, 2022
18-
15+
**Version 1.0 released July 22, 2022**
1916

2017
Multiple Instances
2118
------------------

‎source/release-notes/1.1.txt

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,7 @@ Release Notes for ``mongosync`` 1.1
1212
:depth: 1
1313
:class: singlecol
1414

15-
.. note::
16-
17-
``mongosync`` 1.1 Released January 13, 2023
18-
15+
**Version 1.1 Released January 13, 2023**
1916

2017
Filtered Sync
2118
-------------

‎source/release-notes/1.2.txt

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,7 @@ Release Notes for ``mongosync`` 1.2
1212
:depth: 1
1313
:class: singlecol
1414

15-
.. note::
16-
17-
``mongosync`` 1.2 Released February 16, 2023
18-
15+
**Version 1.2 Released February 16, 2023**
1916

2017
Migrating Older Versions of MongoDB
2118
-------------------------------------

‎source/release-notes/1.3.txt

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,7 @@ Release Notes for ``mongosync`` 1.3
1212
:depth: 2
1313
:class: singlecol
1414

15-
.. note::
16-
17-
``mongosync`` 1.3 Released April 13, 2023
15+
**Version 1.3 Released April 13, 2023**
1816

1917
New Features
2018
-------------

‎source/release-notes/1.4.txt

Lines changed: 67 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,7 @@ Release Notes for ``mongosync`` 1.4
1212
:depth: 2
1313
:class: singlecol
1414

15-
.. note::
16-
17-
``mongosync`` 1.4 Released <<TBD>>, 2023
15+
**Version 1.4 released June 16, 2023**
1816

1917
New Features
2018
-------------
@@ -27,7 +25,73 @@ Starting in 1.4.0, you can set the workload level that
2725
destination clusters. For more information, see the
2826
:option:`--loadLevel` option.
2927

28+
Improved Resiliency for ``oplog`` Rollover
29+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
30+
31+
``mongosync`` 1.4.0 improves :term:`oplog` handling. The ``oplog``
32+
handling improvement adds resiliency to long running operations.
33+
34+
``mongosync`` does an initial data copy and then applies updates from
35+
the ``oplog`` to sync the source and destination clusters. In earlier
36+
versions, ``mongosync`` waits to complete the initial sync before it
37+
begins to replicate any changes from the ``oplog``. If there is a large
38+
initial data set, the ``oplog`` can roll over before ``mongosync`` can
39+
complete the initial data transfer. When this happens, the sync has to
40+
be restarted from the beginning.
41+
42+
Starting in 1.4.0, ``mongosync`` begins to apply changes while the
43+
initial sync is still in progress. Since ``mongosync`` starts to apply
44+
changes earlier, ``mongosync`` maintains a recent position in the
45+
``oplog``. This mitigates the risk of ``oplog`` roll over and
46+
significantly lowers the risk of restarting the sync.
47+
48+
For more information, see :ref:`oplog sizing <c2c-oplog-sizing>`.
49+
50+
Faster Processing
51+
~~~~~~~~~~~~~~~~~
52+
53+
Version 1.4.0 improves ``change event application`` speeds for improved
54+
performance.
55+
56+
Improved Memory Handling
57+
~~~~~~~~~~~~~~~~~~~~~~~~
58+
59+
In version 1.4.0, ``mongosync`` uses less memory to buffer change
60+
events. Improved memory handling alleviates some out-of-memory (OOM)
61+
issues.
62+
63+
Telemetry
64+
~~~~~~~~~
65+
66+
Starting in 1.4.0, ``mongosync`` collects anonymous, aggregated usage
67+
data to improve MongoDB products. You can disable collection of this
68+
:ref:`telemetry <c2c-telemetry>` data when you start ``mongosync``.
69+
70+
Bug Fixes
71+
----------
72+
73+
- Fixes an issue so documents with ``_id`` values that evaluate to the
74+
same string replicate correctly.
75+
76+
- Fixes a collection naming issue. Prior to version 1.4.0, ``mongosync``
77+
crashes when a new collection reuses a dropped collection's name with
78+
letter case changes.
79+
80+
For example, previous versions of ``mongosync`` crash if a new
81+
``SampleName`` collection replaces the dropped ``samplename``
82+
collection.
83+
84+
Additional Considerations
85+
-------------------------
86+
87+
The MongoDB server's :dbcommand:`validate` command may report data
88+
corruption on destination clusters that run MongoDB version 6.0 through
89+
6.0.6. The data on the destination server is not corrupt. A bug in the
90+
:ref:`WiredTiger <storage-wiredtiger>` database engine,
91+
:issue:`WT-11051`, causes the false report.
92+
3093
Minimum Supported Version
3194
-------------------------
3295

3396
In 1.4.0, the minimum supported version of MongoDB is 6.0.5.
97+

0 commit comments

Comments
 (0)