Docs Menu
Docs Home
/
Relational Migrator
/

Deployment Considerations

On this page

  • How to Run Relational Migrator
  • Where to Run Relational Migrator
  • Network Considerations
  • System Hardware
  • Get Started

In the context of Relational Migrator, deployment considerations refers to where the servers, networking equipment, and databases are located. This page outlines location specific details to consider when using Relational Migrator.

The following table outlines high-level recommendations for how to run Relational Migrator. Also note that the Kafka deployment model provides greater resilience and scalability and can be used with any of the deployment options.

Use case
Recommended environment

Smaller scale or debugging and testing jobs that run for less than four hours.

Laptop / Desktop / Docker

Larger scale production jobs that run for more than four hours.

Remote server / EC2 / Azure VM

For best performance, locate the machine or server running Relational Migrator as geographically close to the source and target databases as possible. Proximity to the target database influences performance the most:

  • If you're using Relational Migrator for an on-premises migration, run Relational Migrator in the same data center as the source database.

  • If you're using a cloud hosted database, run Relational Migrator on an EC2 instance or VM in the same VPC as the source database.

Tip

Check the sleep timeout setting for your operating system. If your machine goes to sleep during a migration, the migration job fails.

When using Relational Migrator, the system firewall on the machine or server must allow outbound TCP traffic to both the source and destination databases.

When running Relational Migrator in a cloud environment, check the cloud specific firewall (security group), router table, and the server firewall configurations. For details on specific cloud provider network configurations, see these pages:

  • AWS Networking

  • Azure Networking

  • GCP Networking

By default, Relational Migrator includes telemetry that reports usage information and errors back to MongoDB to help improve the product. This telemetry does not include any sensitive details such as database connection strings, schema information or customer data.

You can disable telemetry by editing the application's user.properties file, adding the following line, and restarting Relational Migrator:

migrator.app.telemetry.enable: false

For specific hardware recommendations, see System Requirements.

Note

Scaling up the Atlas cluster size can significantly improve migration speeds. For details, see Modify the Cluster Tier.

For detailed installation instructions, see Installation.

Back

System Requirements