Installation on Linux

Check supported platforms

See the list of supported operating systems for the DBmarlin server installation.

Pre-requisites

See the checklist of requirements before starting to install the DBmarlin server.

  1. DBmarlin requires netstat which is part of net-tools. If it is not installed it can be installed using yum or apt if required.

    # Check if file exists
    which netstat
    /bin/netstat
    # Install if needed RHEL or Centos
    sudo yum install net-tools
    # Install if needed Ubuntu
    sudo apt-get install net-tools
  2. Check that ports 9080, 9090 and 9070 (or the ones you choose if you customised them) are not in use before starting the DBmarlin server.

    netstat -na | grep LISTEN | grep 9080
    netstat -na | grep LISTEN | grep 9090
    netstat -na | grep LISTEN | grep 9070
  3. Optionally create a dbmarlin Linux user and dbmarlin group.

    useradd dbmarlin
    mkdir /opt/dbmarlin
    chown dbmarlin:dbmarlin /opt/dbmarlin

Downloading the latest version

Download the dbmarlin-Linux-x64-latest.tar.gz file from https://download.dbmarlin.com

Extracting the tar.gz file

cd /opt
tar -xzvf dbmarlin-Linux-x64-latest.tar.gz

Configuring the installation

After extracting the tar.gz file you will find configure.sh which needs to be run first before you can start up the server. This configures ports and other settings.

cd /opt/dbmarlin
./configure.sh
Press Enter then space bar to scroll
...
Do you accept the agreement Y/N ? y
Done.
Set port for Nginx (current 9090): 9090
Set port for Tomcat (current 9080): 9080
Set port for PostgreSQL (current 9070): 9070
See https://docs.dbmarlin.com/docs/Getting-Started/hardware-requirements for Profile sizes
1) XSmall
2) Small
3) Medium
4) Large
5) Xlarge
Choose the profile [1-4]: 2
Small profile selected
Recommended RAM is 4GB. You have 4G
Continue Y/N ? y
Configuring DBmarlin now...
Changing Nginx port from 9090 to 9090
Changing Tomcat port from 9080 to 9080
Using profile Small
All done!
Use ./start.sh to startup the DBmarlin services

Starting DBmarlin server processes

All server processes (nginx, tomcat, postgres) can be started with a single start.sh command.

cd /opt/dbmarlin
./start.sh

Checking the status of DBmarlin server processes

Check the status of the DBmarlin server processes with the status.sh command.

cd /opt/dbmarlin
./status.sh
nginx (Running)
tomcat (Running)
postgres (Running)

Stopping the DBmarlin server processes

All server processes (nginx, tomcat, postgres) can be stopped with a single stop.sh command.

cd /opt/dbmarlin
./stop.sh

Video Walkthough

This short video walkthough covers all the steps listed above showing how to get DBmarlin up and running on Linux.