Install on Windows

About This Task

Relational Migrator uses the following file locations on Windows:

• Configuration file

  c:\Users\<username>\AppData\Local\MongoDB\Relational Migrator\Data\user.properties

• Downloaded JDBC Drivers

  c:\Users\<username>\AppData\Local\MongoDB\Relational Migrator\Data\Drivers

• Log files

  c:\Users\<username>\AppData\Local\MongoDB\Relational Migrator\Data\Logs\migrator.log

Steps

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

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

3. When you are prompted with the MongoDB Relational Migrator Setup Wizard, click Next.

   Accept the license agreement and click Next to continue.

4. Click Install to start your Migrator installation.

5. Click Finish to exit the installer.

6. (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:

      • MySQL: latest 9.1.x version, Platform Independent Version

      • Oracle: 21.6.0.0 of ojdbc11.jar from the Oracle 21c

      • DB2: latest 3.x or 4.x db2jcc.jar

   2. Copy the driver files to c:\Users\<username>\AppData\Local\MongoDB\Relational Migrator\Data\Drivers.

   Note

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

7. Double-click the MongoDB Relational Migrator.exe 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