From 5f43097b3b40560f07bc5b75e98f43e051849eab Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Wed, 19 Mar 2025 12:27:31 -0400 Subject: [PATCH 1/6] DOCSP-48354-1.13-release-notes --- source/release-notes.txt | 4 ++- source/release-notes/1.13.txt | 65 +++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+), 1 deletion(-) create mode 100644 source/release-notes/1.13.txt diff --git a/source/release-notes.txt b/source/release-notes.txt index 4599b03d2..6d9f9d607 100644 --- a/source/release-notes.txt +++ b/source/release-notes.txt @@ -12,11 +12,12 @@ release notes. Current Stable Release ~~~~~~~~~~~~~~~~~~~~~~ -- :ref:`c2c-release-notes-1.12` +- :ref:`c2c-release-notes-1.13` Previous Releases ~~~~~~~~~~~~~~~~~ +- :ref:`c2c-release-notes-1.12` - :ref:`c2c-release-notes-1.11` - :ref:`c2c-release-notes-1.10` - :ref:`c2c-release-notes-1.9` @@ -36,6 +37,7 @@ Previous Releases .. toctree:: :titlesonly: + 1.13 1.12 1.11 1.10 diff --git a/source/release-notes/1.13.txt b/source/release-notes/1.13.txt new file mode 100644 index 000000000..2fdcb0876 --- /dev/null +++ b/source/release-notes/1.13.txt @@ -0,0 +1,65 @@ +.. _c2c-release-notes-1.13: + +================================ +Release Notes for mongosync 1.12 +================================ + +.. contents:: On this page + :local: + :backlinks: none + :depth: 2 + :class: singlecol + +This page describes changes and new features introduced in +{+c2c-full-product-name+} 1.13. + +.. _1.13.0-c2c-release-notes: + +1.13.0 Release +-------------- + +**March 25, 2025** + +MongoDB 8.0 support +~~~~~~~~~~~~~~~~~~~ + +{+c2c-full-product-name+} 1.12 adds support for MongoDB 8.0 on the source +cluster. However, it does not migrate Persistent Query Settings (PQS), which +are new in 8.0. If your source cluster uses PQS, you must :ref:`migrate them +manually `. + +For a full list of supported versions, see :ref:`c2c-server-version-compatibility`. + + +``enableUserWriteBlocking`` parameters +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The ``enableUserWriteBlocking`` parameter in the +:ref:`/start ` API now accepts the following string options: + +- ``"sourceAndDestination"`` for dual write-blocking +- ``"none"`` for no write-blocking + +Use these options instead of the old ``true`` and ``false`` values. +``enableUserWriteBlocking`` still supports ``true`` and ``false`` +for backward compatibility. + +See :ref:`c2c-api-start-params`. + +Live Upgrades +~~~~~~~~~~~~~ + +:ref:`Live upgrades ` +to version 1.12 are not supported. + +Other Notes +~~~~~~~~~~~ + +- Added a machine-friendly label to warnings about Persisted Query Settings + +Minimum Supported Version +------------------------- + +.. include:: /includes/fact-version-compatibility.rst + +.. include:: /includes/migration-upgrade-recommendation.rst From a821926e1361fc62a8273a14f5a10e44dbfe37af Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Wed, 19 Mar 2025 12:49:01 -0400 Subject: [PATCH 2/6] first draft --- source/release-notes/1.13.txt | 55 ++++++++++++++++++++--------------- 1 file changed, 31 insertions(+), 24 deletions(-) diff --git a/source/release-notes/1.13.txt b/source/release-notes/1.13.txt index 2fdcb0876..070785938 100644 --- a/source/release-notes/1.13.txt +++ b/source/release-notes/1.13.txt @@ -1,7 +1,7 @@ .. _c2c-release-notes-1.13: ================================ -Release Notes for mongosync 1.12 +Release Notes for mongosync 1.13 ================================ .. contents:: On this page @@ -20,42 +20,49 @@ This page describes changes and new features introduced in **March 25, 2025** -MongoDB 8.0 support -~~~~~~~~~~~~~~~~~~~ +New Features +~~~~~~~~~~~~ -{+c2c-full-product-name+} 1.12 adds support for MongoDB 8.0 on the source -cluster. However, it does not migrate Persistent Query Settings (PQS), which -are new in 8.0. If your source cluster uses PQS, you must :ref:`migrate them -manually `. +- ``mongosync`` no longer requires you to fully disable the source + cluster's balancer for migrations started with namespace filtering. + Now, you only have to disable the balancer for collections within the + namespace filter. + + You can leave the balancer enabled for collections outside the filter. + The destination balancer still must be fully disabled for the duration + of the migration. + + .. note:: -For a full list of supported versions, see :ref:`c2c-server-version-compatibility`. + You don't need to disable the source balancer on a per-collection basis. You can + still disable the source balancer globally. +Platform Support +~~~~~~~~~~~~~~~~ -``enableUserWriteBlocking`` parameters -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +``mongosync`` builds are now available for the following platforms: -The ``enableUserWriteBlocking`` parameter in the -:ref:`/start ` API now accepts the following string options: - -- ``"sourceAndDestination"`` for dual write-blocking -- ``"none"`` for no write-blocking - -Use these options instead of the old ``true`` and ``false`` values. -``enableUserWriteBlocking`` still supports ``true`` and ``false`` -for backward compatibility. - -See :ref:`c2c-api-start-params`. +- Ubuntu 22.04 and 24.04 +- Amazon Linux 2023 Live Upgrades ~~~~~~~~~~~~~ -:ref:`Live upgrades ` -to version 1.12 are not supported. +:ref:`Live upgrades ` from version 1.12 to 1.13 are +supported. Other Notes ~~~~~~~~~~~ -- Added a machine-friendly label to warnings about Persisted Query Settings +Fixed Issues: + +- Fixed a bug introduced in v1.0.0 where ``mongosync`` could exit + gracefully (instead of crashing with a fatal level log) on some + errors. + +- Fixed a bug introduced in v1.11.0 where ``mongosync`` returned a + confusing error when the user lacked sufficient permissions to enable + destination-only write blocking by default. Minimum Supported Version ------------------------- From 3e15b039b007be7be171707d9c84c57735b33518 Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Wed, 19 Mar 2025 12:54:49 -0400 Subject: [PATCH 3/6] update snooty.toml --- snooty.toml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/snooty.toml b/snooty.toml index ba7decf4b..d9456285d 100644 --- a/snooty.toml +++ b/snooty.toml @@ -29,9 +29,9 @@ toc_landing_pages = ["/quickstart", [constants] version = "1.12" -version-previous = "1.11" -latest-version="1.12.0" -version-dev = "1.13" +version-previous = "1.12" +latest-version="1.13.0" +version-dev = "1.14" c2c-product-name = "Cluster-to-Cluster Sync" c2c-full-product-name = "MongoDB Cluster-to-Cluster Sync" mdb-download-center = "`MongoDB Download Center `__" @@ -53,4 +53,4 @@ targets = [ variant = "warning" value = """\ MongoDB ``mongosync`` binaries are not supported or tested for use with non-genuine MongoDB deployments. While the tools may work on these deployments, compatibility is not guaranteed. - """ \ No newline at end of file + """ From dfdb6793606d363f8952bb8e3145f23c64d92974 Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Wed, 19 Mar 2025 12:56:48 -0400 Subject: [PATCH 4/6] line break --- source/release-notes/1.13.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/release-notes/1.13.txt b/source/release-notes/1.13.txt index 070785938..ee7b0ddc9 100644 --- a/source/release-notes/1.13.txt +++ b/source/release-notes/1.13.txt @@ -34,8 +34,8 @@ New Features .. note:: - You don't need to disable the source balancer on a per-collection basis. You can - still disable the source balancer globally. + You don't need to disable the source balancer on a per-collection + basis. You can still disable the source balancer globally. Platform Support ~~~~~~~~~~~~~~~~ From 536135d04505b71788d9c7460cbd6957d6aafaaa Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Wed, 19 Mar 2025 13:02:26 -0400 Subject: [PATCH 5/6] update supporte linux platforms list --- source/installation/install-on-linux.txt | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/installation/install-on-linux.txt b/source/installation/install-on-linux.txt index b5af93f3f..f6b51a69c 100644 --- a/source/installation/install-on-linux.txt +++ b/source/installation/install-on-linux.txt @@ -41,11 +41,14 @@ Platform Support systems: - Amazon Linux 2 +- Amazon Linux 2023 - Red Hat Enterprise Linux (RHEL) 7 - Red Hat Enterprise Linux (RHEL) 8 - Red Hat Enterprise Linux (RHEL) 9 - Ubuntu 18.04 - Ubuntu 20.04 +- Ubuntu 22.04 +- Ubuntu 24.04 Version Requirements ~~~~~~~~~~~~~~~~~~~~ From 79b837541b818c2fa3c7fc07eaf2715197b0cc87 Mon Sep 17 00:00:00 2001 From: jeff-allen-mongo Date: Wed, 19 Mar 2025 13:08:08 -0400 Subject: [PATCH 6/6] wording --- source/release-notes/1.13.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/release-notes/1.13.txt b/source/release-notes/1.13.txt index ee7b0ddc9..e3f58f50f 100644 --- a/source/release-notes/1.13.txt +++ b/source/release-notes/1.13.txt @@ -34,8 +34,8 @@ New Features .. note:: - You don't need to disable the source balancer on a per-collection - basis. You can still disable the source balancer globally. + You don't need to disable the source balancer on individual + collections. You can still disable the source balancer globally. Platform Support ~~~~~~~~~~~~~~~~