KB-1048 Errors related to Appian keystore during application server startup

Parmida Borhani — Wed, 20 May 2020 06:45:12 GMT

Current Revision posted to Appian Knowledge Base by Parmida Borhani on 5/20/2020 6:45:12 AM

Symptoms

When starting the application server after a migration or an upgrade, one of the following errors are observed in the application server log:

FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Caused by: com.appiancorp.common.config.FatalConfigurationException: com.appiancorp.suiteapi.common.exceptions.AppianException: An unexpected error occurred while trying to load the keystore. (APNX-1-4210-005)
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

Cause

The appian.keystore is a secured placeholder for keys and is encrypted during its creation (first application server startup that successfully connected to the primary database). The encrypted password used to secure the appian.keystore is stored in the primary database in the cfg table along with the character set and the initialization vector for the random part of the encryption phase. When the application server starts, the appian.keystore is opened and validated. For this step to be successful, the password in the cfg table must be the one originally used to encrypt the appian.keystore.

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

This error is common when users backload data from environment A to environment B and forget to copy the <APPIAN_HOME>/_admin/shared directory or to copy the primary database. Any of these omissions can lead to the inability to start the application server.

Note: The appian.keystore file cannot be shared between environments.

Action

Copy the <APPIAN_HOME>/_admin/shared directory containing the original appian.keystore from the previous installation to the upgraded installation and make sure the primary database corresponds to the environment.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2020

Tags: installation, application server, upgrade, keystore

KB-1048 Errors related to Appian keystore during application server startup

Parmida Borhani — Wed, 20 May 2020 06:44:17 GMT

Revision 7 posted to Appian Knowledge Base by Parmida Borhani on 5/20/2020 6:44:17 AM

Symptoms

When starting the application server after a migration or an upgrade, one of the following errors are observed in the application server log:

FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Caused by: com.appiancorp.common.config.FatalConfigurationException: com.appiancorp.suiteapi.common.exceptions.AppianException: An unexpected error occurred while trying to load the keystore. (APNX-1-4210-005)
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Note: The appian.keystore file cannot be shared between environments.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2020

Tags: installation, application server, upgrade, keystore

KB-1048 Errors related to Appian keystore during application server startup

Parmida Borhani — Wed, 20 May 2020 06:37:36 GMT

Revision 6 posted to Appian Knowledge Base by Parmida Borhani on 5/20/2020 6:37:36 AM

Symptoms

When starting the application server after a migration or an upgrade, one of the following errors are observed in the application server log:

FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Caused by: com.appiancorp.common.config.FatalConfigurationException: com.appiancorp.suiteapi.common.exceptions.AppianException: An unexpected error occurred while trying to load the keystore. (APNX-1-4210-005)
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Note: The appian.keystore file cannot be shared between environments.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2020

Tags: installation, application server, upgrade, keystore

KB-1048 Errors related to Appian keystore during application server startup

Parmida Borhani — Wed, 20 May 2020 06:36:49 GMT

Revision 5 posted to Appian Knowledge Base by Parmida Borhani on 5/20/2020 6:36:49 AM

Symptoms

When starting the application server after a migration or an upgrade, one of the following errors are observed in the application server log:

FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Caused by: com.appiancorp.common.config.FatalConfigurationException: com.appiancorp.suiteapi.common.exceptions.AppianException: An unexpected error occurred while trying to load the keystore. (APNX-1-4210-005)
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Note: The appian.keystore file cannot be shared between environments.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2020

Tags: installation, application server, upgrade, keystore

KB-1048 Errors related to Appian keystore during application server startup

Parmida Borhani — Wed, 20 May 2020 06:36:05 GMT

Revision 4 posted to Appian Knowledge Base by Parmida Borhani on 5/20/2020 6:36:05 AM

Symptoms

When starting the application server after a migration or an upgrade, one of the following errors are observed in the application server log:

FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Caused by: com.appiancorp.common.config.FatalConfigurationException: com.appiancorp.suiteapi.common.exceptions.AppianException: An unexpected error occurred while trying to load the keystore. (APNX-1-4210-005)
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Note: The appian.keystore file cannot be shared between environments.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2020

Tags: installation, application server, upgrade, keystore

KB-1048 "The internal encryption module is in an inconsistent state" error returned during application server startup

Parmida Borhani — Thu, 21 Feb 2019 00:26:42 GMT

Revision 3 posted to Appian Knowledge Base by Parmida Borhani on 2/21/2019 12:26:42 AM

Symptoms

After performing a migration and starting the application server, the following entries are written to the server logs:

15:21:33,709 INFO [stdout] (ServerService Thread Pool -- 75) 2015-06-10 15:21:33,709 [ServerService Thread Pool -- 75] FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
15:21:33,720 ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Note: The appian.keystore file cannot be shared between environments.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: February 2017

Tags: installation, upgrade

KB-1048 "The internal encryption module is in an inconsistent state" error returned during application server startup

Nick Vigilante — Tue, 14 Feb 2017 18:37:09 GMT

Revision 1 posted to Appian Knowledge Base by Nick Vigilante on 2/14/2017 6:37:09 PM

Symptoms

After performing a migration and starting the application server, the following entries are written to the server logs:

15:21:33,709 INFO [stdout] (ServerService Thread Pool -- 75) 2015-06-10 15:21:33,709 [ServerService Thread Pool -- 75] FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
15:21:33,720 ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: October 2015

Tags: installation, upgrade

KB-1048 "The internal encryption module is in an inconsistent state" error returned during application server startup

Nick Vigilante — Tue, 14 Feb 2017 13:43:46 GMT

Revision 2 posted to Appian Knowledge Base by Nick Vigilante on 2/14/2017 1:43:46 PM

Symptoms

After performing a migration and starting the application server, the following entries are written to the server logs:

15:21:33,709 INFO [stdout] (ServerService Thread Pool -- 75) 2015-06-10 15:21:33,709 [ServerService Thread Pool -- 75] FATAL com.appiancorp.common.crypto.KeyStoreConfig - The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)
15:21:33,720 ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/suite]] (ServerService Thread Pool -- 75) 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: The internal encryption module is in an inconsistent state. The keystore password is not present in the primary data source. If migrating or restoring from backup, ensure that the primary data source contains all of the tables and data. (APNX-1-4210-004)

Cause

The error is caused by one of the following:

The appian.keystore file is missing from <APPIAN_HOME>/_admin/shared.
The appian.keystore file cannot be opened/decrypted using the password from the cfg table.

Action

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: February 2017

Tags: installation, upgrade