KB-2309 Tomcat is unable to start: "not-null property references a null or transient value: com.appiancorp.security.ssl.CertificateData.commonName"

Symptoms

The application server is unable to start up in a self-managed version of Appian. The following stack trace is observed in <APPIAN_HOME>/logs/tomcat-stdOut.log:

[com/appiancorp/apikey/ApiKeySpringConfig.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate 
[com.appiancorp.apikey.crypto.ApiKeySecretInitializer]: Factory method 'apiKeySecretInitializer' threw exception; nested exception is java.lang.RuntimeException: org.hibernate.PropertyValueException: not-null property references a null or transient value: com.appiancorp.security.ssl.CertificateData.commonName

Cause

When configuring the custom.properties file, the conf.suite.SERVER_AND_PORT property is misconfigured.

Action

Provide a properly-configured value for conf.suite.SERVER_AND_PORT as so:

conf.suite.SERVER_AND_PORT=<HOST_MACHINE_FQDN>:8080

You can read more about configuring this file in the Local Installation Guide.

Affected Versions

• This article applies to all self-managed versions of Appian.

Last Reviewed: March 2024