Installation Guide

Java SDK

• open-JDK 11
• Higher versions have different servlet specifications and are not compatible with current Tomcat programs.
• Furthermore, the tools like jps are not included by default.
• download zip, unpack and include subdir/bin in PATH

Apache Ant

• Download a binary distribution (currently 1.9.7) from Apache and install it without modification.
• Under Linux this may be achieved by

apt-get install ant

MySQL Server

• Download and install a MySQL server. A compatible product like MariaDB may also be used.
• Under Linux you may use

apt-get install mysql-server

SQL concatenation operator '||'

A lot of Dbat specifications use '||' as the SQL concatenation operator. See this question at stackoverflow.com how to add a MySQL configuration setting which enables this operator. For example, manually create an additional configuration file /etc/mysql../mysql.conf.d/ansi.cnf:

    root@dubhe:/etc/mysql/mysql.conf.d# cat ansi.cnf 
    [mysqld] 
    sql_mode=PIPES_AS_CONCAT

Apache Tomcat

• Modify one line in catalina.properties (under Linux for example in /etc/tomcat8/conf/, under Windows in some path like C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf\):

common.loader="c:/var/lib/tomcat/openlib/*.jar","${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar"

Newer versions of Tomcat may not allow the quotes around the path names:

common.loader=c:/var/lib/tomcat/openlib/*.jar,${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar

This entry directs Tomcat to use an additonal directory openlib which contains the JAR files to be shared between all subprojects. Its location is arbitrary, but the ant build.xml files contain the path mentioned above (without "c:" for Linux).

• Modify one line in conf/server.xml:

  <Host name="localhost"  appBase="c:/var/lib/tomcat/webapps"
     unpackWARs="true" autoDeploy="true">

• Copy the jars from the Tomcat installation ./lib to /usr/share/tomcat/lib.
• Under Linux, create symbolic links to the versioned Tomcat directories:

sudo ln -s /var/lib/tomcat8   tomcat
sudo ln -s /usr/share/tomcat8 tomcat

• Make libraries writable by all users:

sudo chmod 777 /var/lib/tomcat/webapps
sudo mkdir     /var/lib/tomcat/openlib
sudo chmod 777 /var/lib/tomcat/openlib

• Restart the Tomcat service.

Installation Test

Common is small and can be used for a first installation test.

mkdir -p work/gits
cd work/gits
git clone https://github.com/gfis/common
cd common
ant fill.lib
ant clean javadoc deploy