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

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

The db_PX*.log shows 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

1. Apply the latest hotfix to your Appian installation or upgrade to the latest version of Appian.
2. Open the change-paths.bat|sh script located in <APPIAN_HOME>/_admin/_scripts/tools and modify the following parameters:
   • OLD_PATH_ARCHIVED=##OLD PATH TO THE ARCHIVED PROCESS DIRECTORY
   • NEW_PATH_ARCHIVED=##NEW PATH TO THE ARCHIVED PROCESS DIRECTORY
3. Shut down all Appian components besides the engines.
4. Run the change-paths.bat|sh script with a user that has sufficient privileges (e.g., the user configured to run Appian).
5. Start up the other Appian components.
6. 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.