Install on Ubuntu

About This Task

Relational Migrator uses the following file locations on Ubuntu and Debian Linux:

• Configuration file

  ~/Migrator/user.properties

• Downloaded JDBC Drivers

  /opt/mongodb-relational-migrator/lib/app/lib

• Log files

  ~/Migrator/Logs/migrator.log

Steps

1. Download the latest .deb binary from the release page.

2. Install Relational Migrator.

   sudo apt install ./mongodb-relational-migrator_<version_number>-1_amd64.deb

3. Change the directory to the Relational Migrator app/lib location.

   cd /opt/mongodb-relational-migrator/lib/app/lib

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:

      • MySQL: latest 8.3.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 /opt/mongodb-relational-migrator/lib/app/lib.

      To copy the driver, use the following example:

      curl https://download.oracle.com/otn-pub/otn_software/jdbc/216/ojdbc11.jar -O -L -b -o

5. Change the directory to the Relational Migrator /bin location and start the application.

   cd /opt/mongodb-relational-migrator/bin
   ./mongodb-relational-migrator

   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