Docs Menu
Docs Home
/
MongoDB Cluster-to-Cluster Sync
/

Release Notes for mongosync 1.8

On this page

  • Patch Releases
  • 1.8.1 Release
  • 1.8.0 Release
  • Updates to mongosync /progress API endpoint
  • Other Notes
  • mongosync Authentication with Atlas Workload Identity Federation
  • Minimum Supported Version

This page describes changes and new features introduced in MongoDB Cluster-to-Cluster Sync 1.8.

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 mongosync 1.8.0 to accommodate a server issue where replica sets that fail to set the replicaSetId configuration can cause mongosync to crash.

August 6, 2024

  • Returns a top-level boolean success field.

  • Returns a new totalEventsApplied field.

  • Reports per-partition progress tracking

See the progress documentation for more details.

Optimizations:

  • Fixes and enhancements to significantly reduce the time needed to create partitions and adds logging that tracks the partition creation process.

Other Changes:

  • mongosync now performs a round robin assignment of the primary shard for each database if the destination is a sharded cluster.

  • mongosync now errors if it cannot create an index after 10 attempts. Previously, the system would attempt to create an index indefinitely.

  • mongosync now sends hostnames as telemetry.

  • mongosync now 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. mongosync now 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 mongosync to 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 mongosync to write certain logs to a location outside of the specified log directory.

  • Fixed a bug introduced in v1.0.0 that caused the mongosync /progress endpoint to potentially return incorrect totalBytes for sharded clusters.

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.

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.

Back

1.9