Install on Ubuntu

About This Task

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

• Configuration file

  ~/.mongodb/relational-migrator/user.properties

• Downloaded JDBC Drivers

  ~/.mongodb/relational-migrator/Drivers

• Log files

  ~/.mongodb/relational-migrator/migrator.log

Steps

1. Download the latest .tar.gz binary from the release page.

2. Install Relational Migrator.

   tar -xvzf relational-migrator-<version_number>-linux-amd64.tar.gz -C /opt

   Note

   You can extract the installation to a location other than the /opt/ directory.

3. (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 ~/.mongodb/relational-migrator/Drivers.

      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

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

   cd /opt/mongodb-relational-migrator-<version_number>/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