DRAFT KB-XXXX Null component error when using XA database

Symptoms

When using Tomcat as the application server and a database and/or driver configured for XA transactions, the following error is seen in the application server log:

SEVERE [localhost-startStop-1] org.apache.tomcat.util.modeler.Registry.registerComponent Null component Catalina:type=DataSource,host=localhost,context=/suite,class=javax.sql.XADataSource,name="jdbc/AppianPrimaryDS"

Cause

This issue has been addressed via AN-123225 in the following versions/hotfixes:

Appian 18.3 Hotfix Package
Appian 18.4 Hotfix Package

Workaround

Use factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" when you specify the XADatasouce in tomcatResources.xml as shown in the Configuring Relational Databases documentation.

Note: This requires the password to be placed in the file in cleartext.

Action

Apply the latest hotfix to your Appian installation or upgrade to the latest version of Appian.

Affected Versions

This article applies to Appian 18.3 and 18.4.

Last reviewed: January 2019