Skip to main content

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. Create a dbmarlin Linux user and dbmarlin group and switch to that user.

     useradd dbmarlin
     mkdir /opt/dbmarlin
     chown -R dbmarlin:dbmarlin /opt/dbmarlin
     su - dbmarlin

Downloading the latest version​

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

Extracting the tar.gz file​

tar -xzvf dbmarlin-Linux-x64-[VERSION].tar.gz -C /opt/

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/server-installation/hardware-requirements for Profile sizes
1) XSmall
2) Small
3) Medium
4) Large
5) Xlarge
Choose the profile [1-5]: 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

Unattended configuration (Optional)​

If you want to automate the running of configure.sh rather than run it interactively, you can pass in command line options. This allows installations and upgrades to be automated through automation tools.

# Example:
./configure.sh -a -n9090 -t9080 -p9070 -sMedium -u

# All parameters must be specified:
-a = Accept license agreement in LICENSE.txt
-n = Nginx port number to use
-t = Tomcat port number to use
-p = PostgreSQL port number to use
-s = Size of profile to use. Valid options are: XSmall, Small, Medium, Large, XLarge
-u = Unattended mode. Script will complete without prompting for Y/N to proceed

For descriptions of profile sizes see Hardware requirements

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.