DOCSP-32917 mongosync 1.6 Release Notes (#160)

* DOCSP-32917 1.6.0 Release Notes

* Adds RN's

* Adds RN's

* Adds RN's

* Minor edits

* Fixes per Jeff

* Fixes per Ajay

* Fixes per Ajay and Dave

* Fixes per Ajay

Co-authored-by: Ajay Vijayakumar <[email protected]>

* Fixes per Ajay

* Fixes typo

---------

Co-authored-by: Ajay Vijayakumar <[email protected]>

Author: kennethdyer

source/reference/limitations.txt

@@ -24,16 +24,24 @@ Limitations
 General Limitations
 -------------------
 
-- The minimum supported server version is MongoDB 6.0.5.
+- The minimum supported server versions are MongoDB 6.0.8 and 7.0.0.
 
   .. include:: /includes/fact-minimum-versions.rst
 
 - ``mongosync`` does not support MongoDB rapid releases such as 6.1 or
   6.2. Only major MongoDB releases such as 6.0 or 7.0. are supported.
   For more information on MongoDB versioning, see
   :ref:`release-version-numbers`.
-- The source and destination clusters must have the same release
-  version.
+- The source and destination clusters must have the same major and minor
+  release version, but can have different patch releases.
+
+  For example,
+  - ``mongosync`` supports sync from a MongoDB 6.0.8 source cluster to a
+    destination cluster using MongoDB 6.0.9, since these are patch releases 
+    of the same major release.
+  - ``mongosync`` does not support sync from a MongoDB 6.0.9 source cluster to 
+    a destination cluster using MongoDB 7.0.0, since they have different major
+    versions.
 - The minimum supported :dbcommand:`Feature Compatibility Version
   <setFeatureCompatibilityVersion>` is 6.0.
 - The source and destination clusters must have the same Feature
@@ -148,4 +156,4 @@ Capped Collections
 System Collections
 ------------------
 
-.. include:: /includes/collections/behavior-system-collections.rst
+.. include:: /includes/collections/behavior-system-collections.rst

source/reference/versioning.txt

@@ -60,9 +60,10 @@ Same Server Version
 ~~~~~~~~~~~~~~~~~~~
 
 {+c2c-product-name+} only supports syncing between the same version of
-MongoDB Server. All three :ref:`server version numbers
-<release-version-numbers>`, including the patch number, must be the
-same on both servers.
+MongoDB Server. The major and minor :ref:`server version numbers
+<release-version-numbers>` must be the same on both clusters.
+Starting in ``mongosync`` 1.6.0, the source and destination cluster
+can use different patch releases of the same major and minor version.
 
 Support Lifecycle 
 ~~~~~~~~~~~~~~~~~

source/release-notes/1.6.txt

@@ -18,7 +18,7 @@ Release Notes for mongosync 1.6
 1.6.0 Release
 -------------
 
-**Upcoming**
+**September 18, 2023**
 
 Exclusion Filters
 ~~~~~~~~~~~~~~~~~
@@ -42,7 +42,64 @@ For more information, see :ref:`c2c-filter-regex`.
 
 Starting in 1.6.0, ``mongosync`` supports sync with MongoDB 7.0.
 
+Other Notes
+~~~~~~~~~~~
+
+New Features:
+
+- Sped up the commit process by parallelizing metadata cleanup. 
+
+- Reduced memory allocation during change event application by approximately 
+  30% for pre-6.0 releases of MongoDB Server versions.
+
+- Changed telemetry to also send error messages to Segment when ``mongosync``
+  exits with a fatal error.
+
+- Added support for ``mongosync`` to sync between source and destination 
+  clusters that have the same major and minor versions, but different 
+  patch versions.
+
+- Upgraded build to use Go 1.20.
+
+- ``mongosync`` now periodically logs when server operations take a longer 
+  than expected time.
+
+Issues Fixed:
+
+- Fixed a bug introduced in 1.5, where ``mongosync`` could fail to apply change
+  events for a document if they occur shortly after the document is copied during
+  the Collection Copy phase.
+
+- Fixed a bug where ``mongosync`` could crash due to the source cluster containing
+  legacy indexes with unknown index options.
+
+- Fixed a bug where ``mongosync`` could crash with an error during change event 
+  application, if the application fails to read 500 documents within 5 minutes
+  or reaches the end of the oplog when reading from change streams on the source
+  cluster.
+
+- Fixed a bug where ``mongosync`` could crash when indexes apply constraints 
+  to collection documents.
+
+  This crash occured when such an index was added or dropped at nearly the same
+  time as an index that violated these constrains was deleted or inserted.  It 
+  would manifest with an error like:
+
+  .. code-block:: text
+     :copyable: false
+
+     Ambiguous field name found in array (do not use numeric field names in embedded elements in an array)
+
+  or a similar error. This fix makes this crash less likely, but it does not
+  elimiate the possibility that it will occur.
+
+
+
+- Fixed a bug where ``mongosync`` can fail to copy certain documents if 
+  the insertion of documents causes duplicate key errors at the same time 
+  as a write concern error. This bug has been present in mongosync since its first release and may have arisen if the destination cluster logs reported a write concern error alongside a duplicate key error.
+
 Minimum Supported Version
 -------------------------
 
-In 1.6, the minimum supported version of MongoDB is 6.0.8.
+In 1.6, the minimum supported versions of MongoDB are 6.0.8 and 7.0.0.