KB-1228 "Appian requires that the JVM timezone be set to GMT" error thrown when starting up JBoss

Symptoms

JBoss

JBoss deployment fails with the following error:

ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 61) 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: Aborting application server start up. Appian requires that the JVM timezone be set to GMT. Use -Duser.timezone=GMT when starting the JVM. (APNX-1-4285-001)
    at ...

Tomcat

Tomcat deployment fails with following error:

FATAL com.appiancorp.common.jvm.GmtTimezoneAsserter - Aborting application server start up. Appian requires that the JVM timezone be set to GMT. Use -Duser.timezone=GMT when starting the JVM.{code}

WebLogic

WebLogic deployment fails with the following error:

Appian requires that the JVM timezone be set to GMT. Use -Duser.timezone=GMT when starting the JVM.

This error is seen even though the user has set the right arguments from the WebLogic Admin Console.

Cause

Appian requires the application server JVM’s timezone to be set to GMT for the successful deployment of the application. Setting it to any other timezone would cause the deployment to fail with the above error.

Weblogic ignores the JVM arguments when set via the WebLogic Admin Console.

Action

JBoss

For Windows, edit standalone.conf.bat present under <JBOSS_HOME>\bin and set the following variable:

set JAVA_TIMEZONE=GMT

For Linux, edit standalone.conf present under <JBOSS_HOME>/bin and set the following variable:

JAVA_TIMEZONE=GMT

Tomcat

Within the setenv.sh|bat file located at <APPIAN_HOME>/tomcat/apache-tomcat/bin, ensure that CATALINA_OPTS=%CATALINA_OPTS% -Duser.timezone is set to GMT.

WebLogic

Set the JVM settings via the setDomainEnv.sh script as described in Configure JVM Settings.

Affected Versions

This article applies to all versions of Appian.