The installation procedure described in this section applies to Ubuntu and Debian 64-bit distributions.
Prerequisites
OpenJDK
As mentioned in the Requirements section, MigratoryData Portal requires Java Runtime Environment (JRE) version 17 or later. For example, to install OpenJDK 17, run:
sudo apt-get install -y openjdk-17-jre-headless
Validate the installation:
java -version
The output should be similar to:
openjdk version "17.0.2" 2024-10-15 LTS
MigratoryData Portal
Install
Download the MigratoryData Portal as a DEB package and install it using the following command:
dpkg -i migratorydata-portal-<version>_<arch>.deb
Replace <version> and <arch> with the actual package version and architecture (e.g. 1.0.4_amd64.deb).
After installation, the following layout is created:
| Location | Description |
|---|---|
/etc/migratorydata-portal/migratorydata-portal.conf |
Default configuration file |
/etc/default/migratorydata-portal |
System environment variables |
/var/log/migratorydata-portal/ |
Log directory |
/usr/share/migratorydata-portal/migratorydata-portal.jar |
Executable JAR |
/usr/bin/migratorydata-portal |
Start script |
/lib/systemd/system/migratorydata-portal.service |
Systemd service unit |
/usr/share/doc/migratorydata-portal/ |
Documentation and license files |
Verify Installation
The service is started automatically after installation. You can manage it using:
systemctl start migratorydata-portal
systemctl stop migratorydata-portal
systemctl restart migratorydata-portal
systemctl status migratorydata-portal
Test Installation
To test the installation, open a browser on the host machine and navigate to:
http://localhost:8080
localhost with the remote machine's IP address or hostname.
Upgrade
To upgrade MigratoryData Portal, download the new DEB package and run:
dpkg -i migratorydata-portal-<version>_<arch>.deb
.dpkg-dist files.
Uninstall
To uninstall MigratoryData Portal, run:
dpkg --purge migratorydata-portal