Tomcat installation on Windows server

Warning This document only gives general guidelines, not a detailled procedure. If needed refer to the Linux installation document for details.

This document corresponds to an installation on Windows server 2012r2.

This procedure also is very similar if you use TomEE instead of Tomcat

Databases

If needed download and install the chosen up-to-date database engine server suitable for your version of Windows:

Nothing to do for HSQLDB as its JAR is part of the application's libraries.

JDK

Dowload and install an up to date Windows Java SE Developpement Kit version 8 (not a Java SE Runtime Environment) package suitable for your version of Windows.

Register the JAVA_HOME environment variable as the path of your JDK Installation (e.g. C:\Program Files\Java\jdk1.8.0_xxx).

Add %JAVA_HOME%\bin to the system PATH.

Tomcat

Clone the preconfigured Tomcat package (which is just an out of the box Tomcat package with administration webapps removed, with some settings fine-tuned and with some additional jars in the lib folder) with appropriate credentials:

git clone https://<username>[:<password>]@platform.git.simplicite.io/tomcat.git

Make sure the tomcat\temp folder is present and writeable, this is mandatory for images thumbnails generation.

Then, make sur the tomcat\logs folder is present and writeable, this is mandatory for logging.

Register the TOMCAT_HOME environment variable as the path of your Tomcat Installation (e.g. C:\Users\Administrator\apache-tomcat-x.y.z).

Change the Tomcat connectors port numbers in conf/server.xml from 8080 to 80 and from 8443 to 443.

If you want to install it as a service proceed as follows:

cd tomcat\bin
.\service.bat install
.\tomcat8.exe //US//Tomcat8 ++JvmOptions -Dfile.encoding=UTF-8;-Dgit.basedir=C:\Users\Administrator\git --JvmMs 256 --JvmMx 1024 --Startup auto

Note that C:\Users\Administrator, 256 and 1024 values are just given as examples.

Application

For MySQL/MariaDB or PostgreSQL or SQLServer: create the database (with UTF-8 encoding) and the database user. Then load the database dump.

Unzip the corresponding dbdoc folder.

Unzip the application WAR in the webapps folder.

Verify the application context configuration (database connection settings and dbdoc location) file in webapps/<app, e.g. ROOT>/META-INF/context.xml

Start the Tomcat service.

Security

Adjust security level (especially for the local Internet Explorer) and firewall settings to expose HTTP (80) and HTTPS (443) ports.