You are currently reviewing an older revision of this page.

DRAFT INT-XXXX Application server fails with "Halting JVM startup: Administration console migration failed." error during an upgrade or migration

Symptoms

The following error is observed in the application server log after an upgrade or migration:

FATAL com.appiancorp.common.web.StartupHaltingServletContextListener - Halting JVM startup: Administration console migration failed.
com.appiancorp.suiteapi.common.exceptions.AppianException: Administration console migration failed. (APNX-1-4282-000)

Cause

The migration of the primary database cannot be completed for one of the following reasons:

  1. The migration has already occurred and is attempting to complete for a second time.
  2. The database software/version cannot support the schema. If this is the case, it is likely that the environment is using a database that is not specified in the Appian System Requirements.

In order to determine the exact cause of the issue, the following information is necessary:

  1. The exact version and hotfix the environment is being upgraded to and from.
  2. The detailed steps followed to complete the upgrade/migration.
  3. A SQL dump of the primary database.

Action

  1. Gather the above information.
  2. Examine the SQL dump of the primary database. Note: as this will likely contain PII, it may be necessary to examine the contents with the customer via WebEx.
  3. If it is determined that the database cannot support the schema, ensure that the environment is using a database that is specified in the Appian System Requirements.
  4. If it is determined that the migration has previously been performed (e.g. the data that failed to migrate already exists in the database), revert the primary database/environment to a backup taken before the upgrade/migration. Perform the upgrade/migration again and ensure that the data migration is only performed one time.

Affected Versions

This article applies to all Appian environments undergoing an upgrade or migration.

Last Reviewed: November 2018