Skip to main content

Installation on Windows

Check supported platforms​

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

Downloading the latest version​

Download the DBmarlin-Agent-Windows-[VERSION]-x64-setup.exe file from https://download.dbmarlin.com

Run the installer and follow the prompts.

windows-agent-install-1.png

Accept the license agreement.

windows-agent-install-2.png

Select the installation location.

windows-agent-install-3.png

Set the values of the 3 DBMARLIN environment variables.

windows-agent-install-4.png

  • 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.

Wait till the file copy completes

windows-agent-install-5.png

Click Finish.

windows-agent-install-6.png

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 added using the Java keytool command that is bundled with the agent. Run the commands below in a PowerShell window opened with Run as administrator (needed to write to C:\Program Files). The only values you should need to change are $DBMARLIN_HOME (if you didn't install to the default location) and $CA_CERT (the path to your CA root certificate file). The commands find the bundled Java version for you.

# Change these two values to match your environment
$DBMARLIN_HOME = "C:\Program Files\DBmarlin-Agent"
$CA_CERT = "C:\path\to\internal-ca.crt"

# Find the Java runtime bundled with the agent (works for any version)
$JAVA_HOME = (Get-ChildItem -Directory "$DBMARLIN_HOME\java\jdk*" | Select-Object -First 1).FullName
Write-Host "Using Java at: $JAVA_HOME"

# Add your CA root cert to the cacerts file
& "$JAVA_HOME\bin\keytool.exe" -import -trustcacerts -noprompt -alias internalCA -file "$CA_CERT" -keystore "$JAVA_HOME\lib\security\cacerts" -storepass changeit

# Check that it was added
& "$JAVA_HOME\bin\keytool.exe" -list -alias internalCA -keystore "$JAVA_HOME\lib\security\cacerts" -storepass changeit

If the Write-Host line prints nothing after "Using Java at:", check that $DBMARLIN_HOME points to the folder containing the java folder. Restart the DBmarlin Agent service after adding the certificate so it picks up the change.

Starting the remote agent process​

You can use Windows Service Manager to start the DBmarlin Agent service.

windows-service.png

Chaning the 3 DBMARLIN agent environment variables​

You can use the Windows Environment Variables Manager to change the 3 DBMARLIN agent environment variables.

Go into System Properties > Environment Variables

system-properties.png

Here you can edit the DBMARLIN_ environment variables.

Environment variables.png