You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.

This page describes the installation of the Blueriq Runtime or components like the customer-data-service on the Apache Tomcat Application server.

Deployment of Blueriq Runtime or components

After successful installation of Tomcat, copy the blueriq-runtime-application-<releasenumber>.war to the webapps folder in your Tomcat Installation folder. Tomcat will automatically start deployment of the WAR. After successful deployment Blueriq will be available at: http://<servername>:<portnumber Tomcat>/<WAR name>.

Config location

When you want to provide a 

spring.config.additional-location
to Tomcat, you usually define your own setenv script in the Tomcat installation folder\bin, that is called when Tomcat is started. See examples below.

setenv.bat (Windows)
set CATALINA_OPTS=%CATALINA_OPTS% -Dspring.config.additional-location=file:///D:/config/
setenv.sh (Unix)
export CATALINA_OPTS=$CATALINA_OPTS -Dspring.config.additional-location=file:/config/

Make sure you always end the value of the spring.config.additional-location with a: /

When running Tomcat as a Windows service, please consult the Tomcat Windows service How-To.


Tomcat 9 Service installer

If you have used the Tomcat 9 service installer the "setenv.bat" will not be used. Instead you can open the tomcat service wrapper that can be found in your tomcat installation folder inside the bin directory.

Open the wrapper executable and go to the "Java" tab. Add the following line to the Java Options:

Java tab
-Dspring.config.additional-location=file:///D:/config/


See the example below:


JDBC drivers

When you need to configure JDBC drivers, see Configuring JDBC database drivers for Tomcat.

  • No labels