mongosync. View the
current documentation
for up-to-date guidance on mongosync and instructions on how to upgrade
to the latest version.Important
mongosync does not support live upgrades to version 1.11 due
to the expanded permissions required for mongosync 1.11. To upgrade to the
most recent version, see mongosync Versioning.
Starting in mongosync 1.7.0, you can live upgrade mongosync without
restarting data synchronization operations from the beginning.
After the live upgrade, mongosync continues operations that were in
progress before the upgrade.
To live upgrade mongosync, perform these steps:
Steps
(Optional) Pause the mongosync processes
To pause mongosync, run pause on each running
mongosync process.
You can resume the mongosync processes later from the paused
state, as shown in the final step.
Tip
If you don't want to immediately resume data synchronization
operations after live upgrade, consider pausing the
mongosync processes. This is useful if you're coordinating
operations from multiple mongosync processes.
Download and install the new mongosync binaries
To download and install the new mongosync binaries, see
download and install mongosync.
Initialize the mongosync processes
To initialize the mongosync processes, see
Quickstart. During initialization after a
live upgrade, mongosync updates the persistent metadata.
Resume the mongosync processes
If you paused any mongosync processes earlier in the optional
first step, run resume on all mongosync
processes.
If a data synchronization operation was already in progress before the
live upgrade, new features added in the latest mongosync version may
not all be supported after the live upgrade. Performance improvements
and bug fixes are always supported after the live upgrade. For more
information on the new features that might be supported after a live
upgrade, see the 1.7.0 Release.