KB-2187 Tomcat fails to start with java.io.FileNotFoundException related to Oracle JAR files

Symptoms

When starting Tomcat, the following error is displayed in <APPIAN_HOME>/logs/tomcat-stdOut.log:

SEVERE [localhost-startStop-1] org.apache.catalina.startup.ContextConfig.processContextConfig Parse error in context.xml for [/suite]
 java.io.FileNotFoundException: /usr/local/appian/tomcat/apache-tomcat/conf/tomcatResources.xml (No such file or directory)

This initial error is followed by multiple errors similar to the below, referencing different .jar files:

java.io.FileNotFoundException: /usr/local/appian/tomcat/apache-tomcat/lib/orai18n-mapping.jar (No such file or directory)

Cause

The Oracle JDBC archive contains several companion JARs that are not required for integration with Appian. One of these, xmlparserv2.jar, causes Tomcat startup to fail when imported into /tomcat/apache-tomcat/lib/.

Action

Remove xmlparserv2.jar from /tomcat/apache-tomcat/lib/ folder, and begin the startup process again. 

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: May 2021