Install on Linux

This version of the documentation is archived and no longer maintained. View the current documentation for up-to-date guidance on mongosync usage and instructions on how to upgrade your version of mongosync.

Overview

To configure MongoDB Cluster-to-Cluster Sync on Linux using a downloaded .tgz tarball, follow the steps on this page.

Cluster-to-Cluster Sync is available on select platforms.

Cluster-to-Cluster Sync Version

This tutorial installs the latest version of mongosync.

Considerations

Platform Support

Cluster-to-Cluster Sync is available on the following Linux operating systems:

Amazon Linux 2
Red Hat Enterprise Linux (RHEL) 7
Red Hat Enterprise Linux (RHEL) 8
Ubuntu 18.04
Ubuntu 20.04

Version Requirements

Cluster-to-Cluster Sync supports synchronization between clusters. For information on MongoDB server version compatibility, see MongoDB Server Version Compatibility.

Install Cluster-to-Cluster Sync

Follow these steps to manually install Cluster-to-Cluster Sync from the .tgz.

Download the tarball.

Download the Cluster-to-Cluster Sync .tgz tarball from the following link:

➤ MongoDB Download Center

In the Version dropdown, select the version of Cluster-to-Cluster Sync to download.
In the Platform dropdown, select your Linux platform.
In the Package dropdown, select shell (tgz).
Click Download.

Extract the files from the downloaded archive.

To extract mongosync, use the tar command in a system shell:

tar -zxvf mongosync-*.tgz

Ensure the binary is in a directory listed in your `PATH` environment variable.

The mongosync binary is in the bin/ directory of the unpacked tarball. To add the location of the mongosync binary to your PATH, do one of the following:

Copy the binary into a directory listed in your PATH variable, such as /usr/local/bin. (Update /path/to/mongosync/bin to reflect the location where you extracted the tar file.)
```
sudo cp /path/to/mongosync/bin/mongosync /usr/local/bin/
```
Create symbolic links to the mongosync binary from a directory such as /usr/local/bin that is already in your PATH. (Update /path/to/mongosync/bin to reflect the location where you extracted the tar file.)
```
sudo ln -s  /path/to/mongosync/bin/mongosync /usr/local/bin/mongosync
```

Back

Install

macOS