mongosync. View the
current documentation
for up-to-date guidance on mongosync and instructions on how to upgrade
to the latest version.This page describes changes and new features introduced in MongoDB Mongosync 1.8.
Patch Releases
1.8.1 Release
October 10, 2024
New Features:
Support added for OpenID Connect (OIDC) authentication with the workload (machine) flow. For more information, see mongosync Authentication with Atlas Workload Identity Federation.
Issues Fixed:
Fixed bug introduced in
mongosync1.8.0 to accommodate a server issue where replica sets that fail to set thereplicaSetIdconfiguration can causemongosyncto crash.
1.8.0 Release
August 6, 2024
Updates to mongosync /progress API endpoint
Returns a top-level boolean
successfield.Returns a new
totalEventsAppliedfield.Reports per-partition progress tracking
See the progress documentation for more details.
Other Notes
Optimizations:
Fixes and enhancements to significantly reduce the time needed to create partitions and adds logging that tracks the partition creation process.
Other Changes:
mongosyncnow performs a round robin assignment of the primary shard for each database if the destination is a sharded cluster.mongosyncnow errors if it cannot create an index after 10 attempts. Previously, the system would attempt to create an index indefinitely.mongosyncnow sends hostnames as telemetry.mongosyncnow exits with an error if it stops and restarts with a different source or destination cluster than previously specified.Improved performance of the initialization process by eliminating the creation of unnecessary dummy indexes.
mongosyncnow creates dummy indexes for sharded collections only if the destination cluster does not have an index to support the shard key.
Issues Fixed:
Fixed a bug introduced in v1.0.0 that caused
mongosyncto fall off the source cluster's oplog if no writes occurred on the source cluster for an extended period of time.Fixed a bug introduced in v1.0.0 that caused
mongosyncto write certain logs to a location outside of the specified log directory.Fixed a bug introduced in v1.0.0 that caused the
mongosync/progressendpoint to potentially return incorrecttotalBytesfor sharded clusters.
mongosync Authentication with Atlas Workload Identity Federation
Starting in 1.8.1, you can use mongosync with Atlas Workload
Identity Federation to authenticate connections to
MongoDB clusters running on Microsoft Azure and Google Cloud Platform.
For details, see Authentication Using Workload Identity Federation.
Minimum Supported Version
In 1.8.0, the minimum supported versions of MongoDB are 6.0.16 and 7.0.9.
For best performance, upgrade your source and destination clusters to the most recent MongoDB Server patch release prior to migration. For more information, see Upgrade to the Latest Self-Managed Patch Release of MongoDB.