RHEL/CentOS Systems Installation

On this page

About this Task

Steps
Install Relational Migrator
Run as a System Service
Next Steps

You can install Relational Migrator on a Red Hat Enterprise Linux (RHEL)/CentOS server. This installation method allows Relational Migrator to run on an unattended server. When running on an unattended server, Relational Migrator binds to any IP and port on the server and exposes it as a web application.

About this Task

Relational Migrator uses the following file locations on RHEL/CentOS:

Configuration file
~/Migrator/user.properties
Downloaded JDBC Drivers
/opt/mongodb-relational-migrator/lib/app/lib
Log files
~/Migrator/Logs/migrator.log

Steps

Install Relational Migrator

Download the latest .rpm binary from the release page.
Install Relational Migrator.
```
sudo yum install mongodb-relational-migrator-<version_number>-1.x86_64.rpm
```
(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 you configure TLS/SSL for Relational Migrator on your unattended server. You can bind Relational Migrator to any IP and port on the server. For additional information, see 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, update the server.port line in your user.properties file to specify your preferred port.
Run Relational Migrator using the binary.
The path to the bin directory is /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.

Run as a System Service

When you install Relational Migrator on a RHEL/CentOS server, you can also set up Relational Migrator to run as a system service. When running Relational Migrator as a system service, Relational Migrator automatically starts when the server starts.

Create a /etc/systemd/system/migrator.service file.
Copy the text below into the /etc/systemd/system/migrator.service file. Replace the binary path as needed.
```
[Unit]
Description=MongoDB Relational Migrator
[Service]
ExecStart="/opt/mongodb-relational-migrator/bin/MongoDB Relational Migrator"
[Install]
WantedBy=multi-user.target
```
Reload systemd to read the newly-created service:
```
systemctl daemon-reload
```
Enable the Relational Migrator service to run on startup and start for the current session.
You can manage the service with systemctl commands. To run on startup and start the current session, run the following:
```
systemctl enable migrator.service
systemctl start migrator.service
```

Next Steps

Create and Manage Projects

Back

Windows Server

Debian Linux