Configuring Tomcat 8.5 on windows and Linux (Fresh installation and upgrade)
 

Configuring Tomcat 8.5 on windows and Linux (Fresh installation and upgrade)

Please refer to the below table for details about what version of OpenJDK is supported for which version of Footprints:
 

FootPrints Version	OpenJDK Version
Footprints 20.20.02	OpenJDK 12.0.2 & 13.0.2
Footprints 20.20.01	OpenJDK 12.0.2 & 13.0.2
FootPrints 20.19.03	OpenJDK 12.0.2 & 13.0.2
FootPrints 20.19.02	OpenJDK 12.0.2
FootPrints 20.19.01	OpenJDK 11.0.2

The examples below are for version 20.19.01 and use OpenJDK 11.0.2 - please change the paths as required in the examples below for the supported version of OpenJDK that you are installing.



Windows

1. Download “Open JDK from this link
2. Extract it to the following location (e.g : C:\Program Files\Java\jdk-11.0.2)
3. Set JAVA_HOME environment variable and add it to the path variable too (make sure in Path variable the location is added at the beginning )

e.g. JAVA_HOME= C:\Program Files\Java\jdk-11.0.2

1. Open Tomcat 8.5 Properties panel > go to Java tab and add the OpenJDK 11 jvm.dll location

e.g. C:\Program Files\Java\jdk-11.0.2\bin\server\jvm.dll


 
 
 
Configuring Tomcat 8.5 on Linux (FootPrints 20.19.01 Fresh Install)

1. Download Open JDK from this link
2. Extract it to a location (e.g. /opt/java/jdk-11.0.2)
3. Set JAVA_HOME environment Linux

JAVA_HOME="/opt/java/jdk-11.0.2"
export JAVA_HOME
export PATH=$PATH:$JAVA_HOME/bin
 

1. Run “echo $JAVA_HOME “in terminal to confirm if the JAVA_HOME is set to OpenJDK 11.0.2 (a restart might be required if not configured)
2. Download Tomcat 8.5, if already download open location where Tomcat 8.5 is extracted

Go to the /bin folder of the Tomcat 8.5 file location
e.g.
/opt/apache/ apache-tomcat-8.5.34/bin

1. Open the setenv.sh file and add a line

export JAVA_HOME=/opt/java/jdk-11.0.2
Tomcat will use OpenJDK 11 (doing this will successfully deploy FootPrints 20.19.01 after FootPrints is installed)
 
 
 
Note: if FootPrints is not started via Tomcat 8.5 and the Tomcat logs contains error related to cxf, add the following line in setenv.sh , this would be just a workaround and is not recommended by Tomcat, defect DRZNZ-5551  is logged for the same
 
export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.cxf.stax.allowInsecureParser=1"
 
  
 
Configuring Tomcat 8.5 on Linux (FootPrints 20.19.01 Upgrade)
 

1. Download Open JDK 11.0.2 from this link
2. Extract it to a location (e.g. /opt/java/jdk-11.0.2)
3. Set JAVA_HOME environment Linux

JAVA_HOME="/opt/java/jdk-11.0.2"
export JAVA_HOME
export PATH=$PATH:$JAVA_HOME/bin
 

1. Run “echo $JAVA_HOME “ in terminal to confirm if the JAVA_HOME is set to OpenJDK11.0.2 (a restart might be required if not configured)
2. Download Tomcat 8.5, if already downloaded open the location where Tomcat 8.5 is extracted to

Go to the /bin folder of the Tomcat 8.5 file location
e.g.
/opt/apache/ apache-tomcat-8.5.34/bin

1. Open the setenv.sh file and add a line

export JAVA_HOME=/opt/java/jdk-11.0.2

Tomcat will use OpenJDK11 (doing this will successfully deploy FootPrints 20.19.01 after FootPrints is installed)
 
Note: if FootPrints is not started via Tomcat 8.5 and the Tomcat logs contains error related to cxf, add the following line in setenv.sh , this would be just a workaround and is not recommended by Tomcat, defect DRZNZ-5551 is logged for the same
 
export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.cxf.stax.allowInsecureParser=1"
 
 

1. For Linux Tomcat 7 and Tomcat 8.5 cannot be deployed on the same port i.e. 8080, 8005 and 8009 , so if you  have FootPrints installed which is prior to 20.18.03 that requires Tomcat 7 for deployment, when upgrading to the latest FootPrints that requires Tomcat 8.5, Ports of Tomcat 7 needs to be changed to some other ports that are not in use by any other application eg. 8181, 8105, 8109 other