KB-1233 "Could not be unarchived: The following user or users do not exist or have been renamed after the process was archived: [user]" error thrown when trying to unarchive a process using the archiveprocess script

Symptoms

The archiveprocess.(bat|sh) script, located under <APPIAN_HOME>/server/_scripts/tools, is unable to unarchive a process because it has a reference to a user that no longer exists in the system with that username.

After unarchiving processes, the follow error is present in the application server log:

ERROR: Engine 1, process XXXXXXXXX (/../../../archived-process/01/5/process_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX_XXXXXXXXXXXXXXX_XXXXXXXXX.l): Could not be unarchived: The following user or users do not exist or have been renamed after the process was archived: [USER NAME]
Log file created: 
<APPIAN_HOME>/logs/archiveprocess_YYYYMMDDHHMMSS.log

Cause

A username was renamed after the process was archived, which causes the archived process to reference the old username.

Action

Using the archiveprocess.(bat|sh) script located in the <APPIAN_HOME>/server/scripts/tools/ directory:

1.Create a file that lists the old username and current username to map to in the format:
[OLD_USERNAME] [CURRENT_USERNAME]
Note: The file can have any name such as usermap
1. Run the following command:
archiveprocess.sh unarchive -pid [PROCESS_ID]-file [ARCHIVED_PROCESS_FILE_NAME].l -usermap [NAME_OF_FILE_WITH_OLD_TO_NEW_USERNAME_MAP]

More information about managing process archives can be found here.

Affected Versions

This article applies to all versions of Appian.