KB-XXXX "java.lang.IllegalStateException: basedir <directory>\ear\suite.ear\web.war does not exist" error thrown during application server startup

Symptoms

During application server startup, the following error is thrown:

21:47:40,069 INFO [stdout] (ServerService Thread Pool -- 92) 2018-03-15 21:47:40,067 [ServerService Thread Pool -- 92] ERROR com.appiancorp.common.config.ConfigObjectRepository - An error occurred while trying to retrieve the list of resources for the config object: [null]
21:47:40,074 INFO [stdout] (ServerService Thread Pool -- 92) java.lang.IllegalStateException: basedir C:\appian\ear\suite.ear\web.war does not exist.
21:47:40,078 INFO [stdout] (ServerService Thread Pool -- 92) at org.apache.tools.ant.DirectoryScanner.scan(DirectoryScanner.java:871)
21:47:40,083 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.common.config.ConfigObjectRepository.getConfigResourceLocations(ConfigObjectRepository.java:282)
21:47:40,088 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.cache.CacheManager.getDefaultConfig(CacheManager.java:94)
21:47:40,093 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.cache.CacheManager.<clinit>(CacheManager.java:56)
21:47:40,097 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.common.MinimalEvaluationEnvironmentBootstrap.configureEvaluationEnvironment(MinimalEvaluationEnvironmentBootstrap.java:52)
21:47:40,101 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.common.MinimalEvaluationEnvironmentContextListener.doContextInitialized(MinimalEvaluationEnvironmentContextListener.java:11)
21:47:40,111 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.common.web.StartupHaltingServletContextListener$1.run(StartupHaltingServletContextListener.java:74)
21:47:40,112 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.security.changelog.AuditLogLocationService.runWithLocation(AuditLogLocationService.java:38)
21:47:40,117 INFO [stdout] (ServerService Thread Pool -- 92) at com.appiancorp.common.web.StartupHaltingServletContextListener.contextInitialized(StartupHaltingServletContextListener.java:71)
21:47:40,120 INFO [stdout] (ServerService Thread Pool -- 92) at org.apache.catalina.core.StandardContext.contextListenerStart(StandardContext.java:3339)
21:47:40,125 INFO [stdout] (ServerService Thread Pool -- 92) at org.apache.catalina.core.StandardContext.start(StandardContext.java:3780)
21:47:40,126 INFO [stdout] (ServerService Thread Pool -- 92) at org.jboss.as.web.deployment.WebDeploymentService.doStart(WebDeploymentService.java:163)
21:47:40,131 INFO [stdout] (ServerService Thread Pool -- 92) at org.jboss.as.web.deployment.WebDeploymentService.access$000(WebDeploymentService.java:61)
21:47:40,134 INFO [stdout] (ServerService Thread Pool -- 92) at org.jboss.as.web.deployment.WebDeploymentService$1.run(WebDeploymentService.java:96)
21:47:40,139 INFO [stdout] (ServerService Thread Pool -- 92) at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
21:47:40,141 INFO [stdout] (ServerService Thread Pool -- 92) at java.util.concurrent.FutureTask.run(FutureTask.java:266)
21:47:40,143 INFO [stdout] (ServerService Thread Pool -- 92) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
21:47:40,150 INFO [stdout] (ServerService Thread Pool -- 92) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
21:47:40,155 INFO [stdout] (ServerService Thread Pool -- 92) at java.lang.Thread.run(Thread.java:748)
21:47:40,158 INFO [stdout] (ServerService Thread Pool -- 92) at org.jboss.threads.JBossThread.run(JBossThread.java:122)

The application server ultimately fails to start.

Cause

The value of AE_HOME defined in appian-home.properties located in <APPIAN_HOME>/ear/suite.ear/conf is not configured correctly or at all.

Action

To fix this issue, perform the following:

1. Stop the application server.
2. Edit appian-home.properties and set the value of AE_HOME to the correct value of <APPIAN_HOME>.
3. Start the application server.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: March 2018