How to upgrade the embedded Tomcat in OFBiz

The intended audience of this document is the OFBiz committers group.
This document is a work in progress.
This document describes the steps required to upgrade the version of the embedded Tomcat, for versions 7.0.27 or greater.

framework/catalina/lib

From the "Embedded Tomcat" distribution, copy to the framework/catalina/lib folder the following jars (and remove the old versions):

• ecj-<VERSION>.jar
• tomcat-embed-core.jar
• tomcat-embed-jasper.jar
• tomcat-embed-logging-log4j.jar (required to enable log4j for internal tomcat logging)

for the core Tomcat engine.

From the "Core Tomcat" distribution, copy to the framework/catalina/lib folder the following jars (and remove the old versions):

• catalina-ha.jar
• catalina-tribes.jar

for clustering support.

framework/base/lib/j2eespecs

From the "Core Tomcat" distribution, copy to the framework/base/lib/j2eespecs folder the following jars (and remove the old versions):

• annotations-api.jar
• el-api.jar
• jsp-api.jar
• servlet-api.jar

they are the standard API specifications; please add the suffix for the specification version (can be found in the Tomcat documentation or in the Manifest file in them).
The current specification versions in OFBiz (and Tomcat 7.0.*) are:

• annotations-api-3.0.jar
• juel-2.2.1.jar
• jsp-api-2.2.jar
• servlet-api-3.0.jar