Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describes the installation of the Blueriq Runtime or components like the customer-data-service on the Apache Tomcat 6/7 Application server. Apache Tomcat can be freely downloaded from http://tomcat.apache.org. This is also the place to look for documentation about the configuration and use of Tomcat.

Deployment of Blueriq Runtime or components

After successful After successfull installation of Tomcat, copy the Aquima-Serverblueriq-runtime-application-<releasenumber>.war to the WebApps webapps folder in your Tomcat Installation folder (by default: C:\Program Files\Apache Software Foundation\Tomcat X.X\). Tomcat will automatically start deployment of the warWAR. After successfull successful deployment Blueriq will be available at: http http://<servername>:<Portnumber Tomcat>/Aquima-Server<portnumber Tomcat>/<WAR name>.

Config location

When you want to provide a 

Include Page
_ConfigLocation
_ConfigLocation
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.

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

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.

Image Added

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

Code Block
titleJava tab
-Dspring.config.additional-location=file:///D:/config/


See the example below:

Image Added


JDBC drivers

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