Skip to main content

Installation on Linux

Check supported platforms​

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

Pre-requisites​

  1. Check that port 9080 is available.

    netstat -na | grep LISTEN | grep 9080

  2. 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-agent-Linux-x64-[VERSION].tar.gz file from https://download.dbmarlin.com

Extracting the tar.gz file​

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

Configuring the installation​

After extracting the tar.gz file you will need to set 3 Environment variables before starting the agent. For example:

export DBMARLIN_AGENT_NAME="My first remote agent"
export DBMARLIN_ARCHIVER_URL=http://dbmarlin-service:9090/archiver
export DBMARLIN_API_KEY=aGVsbG86d29ybGQ=
  • DBMARLIN_AGENT_NAME can be any unique identifier for your remote agent up to 50 characters in length. If it is not set then the agent name defaults to “default”, which is name of the built-in agent. It is important therefore that each agent has its own unique name.
  • DBMARLIN_ARCHIVER_URL is the URL endpoint of the archiver on your DBmarlin server. Remember to include the full URL including scheme://host:port/archiver. The default value for the built-in agent is http://localhost:9080/archiver which goes to the archiver port (9080) directly but for remote agents the port would usually be that of the Nginx reverse proxy (9090) unless you have another load balancer in front, in which case it would be the host and port of the load balancer.
  • DBMARLIN_API_KEY is the Base64-encoded username:password for your DBmarlin server if you are using Nginx Basic Auth. If you are not using authentication then this environment variable can be omitted.

Using SSL to secure agent->archiver communications​

If you have enabled SSL on the DBmarlin server using an SSL Certificate that was signed by Certificate Authority (CA) then you will need to add the CA root certificate to the Java cacerts used by the DBmarlin agent. cacerts is the default truststore for Java which contains a list of trusted root certificate authorities (CAs).

The root certificate can be done using the java keytool command. You will need to adapt the command below to your own paths and certificate names.

# Add you CA Root cert to cacerts file
$DBMARLIN_HOME/java/jdk[VERSION]-jre/bin/keytool -import -trustcacerts -alias internalCA -file internal-ca.crt -keystore $DBMARLIN_HOME/java/jdk[VERSION]-jre/lib/security/cacerts -storepass changeit

# List the certs to see that it was added
keytool -list -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit

Starting the remote agent process​

See Starting and Stopping on Linux