Docs Menu
Docs Home
/
Relational Migrator
/
Installation
/
Developer Installation Guide

Install on Mac

On this page

  • About This Task
  • Steps
  • Next Steps

You can install Relational Migrator on a single Mac machine. This installation method uses default settings and binds Relational Migrator to a single IP and port.

About This Task

Relational Migrator uses the following file locations on MacOS:

  • Configuration file

    ~/Library/Application Support/MongoDB/Relational Migrator/user.properties

  • Downloaded JDBC Drivers

    /Library/Application Support/MongoDB/Relational Migrator/Drivers

  • Log files

    ~/Library/Application Support/MongoDB/Relational Migrator/Logs/migrator.log

Steps

  1. Download the latest MacOS Relational Migrator binary from the release page.

  2. Double-click the MongoDB.Relational.Migrator-<version_number>.dmg file.

  3. Drag the MongoDB Relational Migrator.app icon into the /Applications folder.

  4. (Optional) To connect to Oracle or MySQL drivers, download and place the drivers into your Relational Migrator directory.

    1. To download and install MySQL, Oracle or DB2 drivers, see the following:

    2. Copy the driver files to /Library/Application Support/MongoDB/Relational Migrator/Drivers.

      Note

      Relational Migrator installs the JDBC drivers for SQL Server and PostgreSQL by default.

  5. Open Launchpad and search for MongoDB Relational Migrator.

    Double-click the Relational Migrator icon to start the application.

    Note

    If you start Relational Migrator before you copy the driver files into the Drivers directory, you must restart the application to use the MySQL or Oracle drivers.

Next Steps

  • Create and Manage Projects

Back

Windows

Next

Linux