...

Installing on unix/ linux

Install the login scripts in tomcat login scripts into the tomcat user home directory. These scripts are correct as of Tomcat 8.0 but you should confirm that no changes are needed because of environment differences or because of different versions of tomcat.Follow these instructions.

Anchor
configureTomcat configureTomcat

Configure tomcat

Having completed the basic tomcat installation, stop the tomcat service then make the following changes:

conf/context.xml: cache settings

The default Tomcat cache settings are insufficient for PhixFlow:

Edit $TOMCAT/conf/context.xml:

Add <Resources ... /> to at the end of the <Context/> block in

[tomcat base]/conf/context.xml

so block so that the file looks something like this:

<Context>
    <!-- lines omitted -->
	<Resources cachingAllowed="true" cacheMaxSize="1000000" />
</Context>

conf/server.xml: Connector settings

Edit the <Connector block in Edit $TOMCAT/conf/server.xml to:

Find the line starting <Connector port="8080"

Edit the <Connector block to

• Use the required port number (port="8080"). Tomcat defaults to port 8080 for HTTP, but you may need to use a different port if you are running other web servers on the same host.
• Enable compression (compression="force"). Compressing responses from the server is particularly important if you are going to access the PhixFlow server over a slow connection (e.g. a mobile data connection).

After editing, the <Connector/> block should look like this:

...

Remember to enable this port in the server’s firewall (if enabled).

web.xml: Session timeout

Modify The default session timeout period is 30 minutes.

We recommend that you change this to a longer period, e.g. 12 hours (720 minutes).

Edit $TOMCAT/conf/web.xml to change the Tomcat

Find the line containing <session-timeout.

Change the session timeout period from its default value (30 mins). Find the following lines and change as needed:Once changed, it should look something like this (this example shows a 12-hour timeout).

<session-config>
	<session-timeout>720</session-timeout>
</session-config>

...

Java and JVM Options

Download and install Java from java.com. Java JDK 1.8 is required (and version 1.8.0_74 or greater is recommended). Also install Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files from http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html (required for reading password protected Excel files). The following JVM (Java Virtual Machine) options should be set to control (amongst other things) the amount of memory reserved for Tomcat and therefore made available for PhixFlow. The options are:

...