KB-1103 "Unable to build keystore lock file" error thrown during JBoss startup

Symptoms

JBoss fails to start and shows the following error in the application server log and console:

ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 66) 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: Unable to build keystore lock file. (APNX-1-4210-007)

Caused by: java.io.IOException: Access is denied

The following error may also appear in the application server log:

ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 66) JBWEB000287: Exception sending context initialized event to listener instance of class com.appiancorp.plugins.PluginLoader: java.lang.RuntimeException: Could not create directory [C:\appian\_admin\plugins]

Cause

This happens when JBoss does not have access or sufficient privileges to create the files it needs in the <APPIAN_HOME>/_admin/shared and <APPIAN_HOME>/_admin folders.

Action

Please check to see if the locations are accessible (things like symbolic links pointing to the correct locations) and that the user who is starting JBoss has sufficient privileges for file creation in those locations.

Affected Versions

This article applies to all versions of Appian using JBoss as an application server.