KB-1105 "No value configured for conf.data.APPIAN_DATA_SOURCE in custom.properties" error thrown during application server startup

Symptoms

Upon upgrading to or installing Appian 16.1, the application server log displays the following error:

ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 57) JBWEB000287: Exception sending context initialized event to listener instance of class com.appiancorp.common.config.ConfigurationLoader: com.appiancorp.common.config.FatalConfigurationException: com.appiancorp.suiteapi.common.exceptions.AppianException: An unexpected error occurred while trying to initialize and validate the Appian data source. (APNX-1-4179-004)
(...)
Caused by: com.appiancorp.rdbms.config.PrimaryDataSourceNotConfiguredException: com.appiancorp.suiteapi.common.exceptions.AppianException: FATAL: No value configured for conf.data.APPIAN_DATA_SOURCE in custom.properties. An Appian datasource is required. The Appian application will fail to deploy. (APNX-1-4179-003)

The application server will then fail to deploy Appian.

Cause

Starting Appian 16.1, the property names for configuring data sources in custom.properties has changed from conf.data.primary.datasource to conf.data.APPIAN_DATA_SOURCE.

Refer to List Data Sources in custom.properties for more information.

Action

Ensure the primary data source property is changed to conf.data.APPIAN_DATA_SOURCE.

Affected Versions

This article applies to Appian 16.1 and later.