Install On Debian

On this page

Steps

Next Steps
Learn More

You can install Relational Migrator on a Debian server. This installation method allows Relational Migrator to run on an unattended server. By running on an unattended server, Relational Migrator binds to any IP and port on the server and is exposes it as a web application.

Steps

Download the latest .deb binary from the release page.
Install Relational Migrator.
```
sudo apt install ./mongodb-relational-migrator_X.X.X-1_amd64.deb
```
(Optional) To connect to Oracle or MySQL drivers, download and place the drivers into your Relational Migrator directory.
1. To download and install MySQL or Oracle 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
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
For more information, see Install on a Local Machine.
Change the directory to the Relational Migrator /bin location and start the application.
```
cd /opt/mongodb-relational-migrator/bin
./mongodb-relational-migrator
```
Enable Relational Migrator to run as an unattended standalone server.
In your user.properties file, uncomment spring.profiles.active: unattended.
(Optional) Update TLS/SSL configuration properties.
In your user.properties file, uncomment and update TLS/SSL configuration properties.
It is recommended that the unattended server installation is supplemented with TLS/SSL configuration because Relational Migrator can be bound to any IP and port on the server. For additional information, see TLS/SSL Configuration Properties.
(Optional) Update the port that Relational Migrator runs on.
By default, Relational Migrator is configured to run on port 8278. To change the port Relational Migrator runs on (for example to port 80 for HTTP or port 443 for HTTPS), update the server.port line in your user.properties file to specify your preferred port.
Run Relational Migrator using the binary.
The bin directory can typically be found at /opt/mongodb-relational-migrator/bin. To run Relational Migrator using the binary, run the following:
```
cd /opt/mongodb-relational-migrator/bin
./mongodb-relational-migrator
```
(Optional) Check logs for errors or other information.
- The logs are located in ~/Migrator/Logs/migrator.log.
- When running Relational Migrator as a system service, the path is under the service user’s home directory.

Next Steps

Learn More

Back

Debian Systems

Run as System Service