KB-1222 "Unexpected exception occurred during archiving: process <id>" error thrown after upgrading Appian in a different folder location

This issue has been resolved in an Appian hotfix/new Appian version. Please apply the latest hotfix to your Appian installation or upgrade to the latest version of Appian.

Symptoms

All processes fail to archive after performing an upgrade to a new directory structure. The following errors are seen in the application server log:

[Appian Work Item - XXXX - ProcessExec02 : ArchiveProcessRequest] ERROR com.appiancorp.process.engine.ArchiveProcessRequest - Unexpected exception occurred during archiving: process XXXXXXX
(Appian Work Item - 7886 - ProcessExec02 : ArchiveProcessRequest) com.appiancorp.process.engine.ArchivePrepareException

In the db_PX*.log we would see the following:

[PX001] {peXXX.kdb XXXXXX} (Default) ERROR .a.noa "Failed to create path:##OLD PATH##"

Cause

This is because the system can no longer find the old path to archive the processes due to the change in installation path.

This issue has been addressed via AN-71290 in the following hotfixes/version:

Appian 16.3
Appian 16.2 Hotfix Package B
Appian 16.1 Hotfix Package D
Appian 7.11 Hotfix Package G

Action

Apply the latest hotfix to your Appian installation or upgrade to the latest version of Appian. After doing that, you will have to run the change-paths.sh script located in <APPIAN_HOME>/_admin/_scripts/tools after modifying the following parameters:

OLD_PATH_ARCHIVED=##OLD PATH TO THE ARCHIVED PROCESS DIRECTORY
NEW_PATH_ARCHIVED=##NEW PATH TO THE ARCHIVED PROCESS DIRECTORY

After making this change, run the script with a user that has sufficient privileges (e.g., the user configured to run Appian). Look through the logs to see if any of the above errors are still encountered.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: March 2017