DRAFT KB-XXXX Tomcat fails to deploy Appian with "java.io.FileNotFoundException: <APPIAN_HOME>/tomcat/apache-tomcat/conf/tomcatResources.xml" error

Symptoms

When starting Tomcat, the following error will be 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 being the startup process again. 

Affected Versions

This article applies to Appian 18.3 and later.

Last Reviewed: May 2021