SP-4042 KB - XXXX Checkpoint request is not always final request on shutdown

Symptoms

The issue is affecting the Service Manager component and how it handles Appian Engine checkpointing at shut down. In some cases when an environment is shut down for a Appian version upgrade OR hotfix application it can cause an engine start-up failure. That being said, your environment is functional and safe to restart as long as you do not apply a new Hotfix or perform an Appian version upgrade.

Cause

This is an issue with a bad Service Manager version in the following Appian build versions:

19.4.76.0 to 19.4.89.0

19.3.130.0 to 19.3.141.0

19.2.196.0 to 19.2.208.0

Action

Please reach out to Appian Support to receive the fix for this issue and follow the instructions below to apply the fix:

Unzip the downloaded komodo-1.236.0.zip file into a safe location that is not <APPIAN_HOME>.
Shutdown all components of Appian gracefully
Rename <APPIAN_HOME>/services/bin to <APPIAN_HOME>/services/bin_backup
Rename <APPIAN_HOME>/services/lib to <APPIAN_HOME>/services/lib_backup
From the unzipped download, copy the ‘bin’ directory into <APPIAN_HOME>/services
From the unzipped download, copy the ‘lib’ directory into <APPIAN_HOME>/services
Start Service Manager, ZooKeeper, and Kafka on all engine nodes using <APPIAN_HOME>/services/start.bat|sh -p PASSWORD -s all
Stop Service Manager, ZooKeeper and Kafka on all engine nodes using <APPIAN_HOME>/services/stop.bat|sh -p PASSWORD -s all
Start Appian normally using the steps provided in our “Starting and Stopping Appian” documentation - https://docs.appian.com/suite/help/19.4/Starting_and_Stopping_Appian.html

Once your environment is running with the patch successfully applied, your environment should once again be in a stable state.

Please proceed to perform cleanup by:

Removing <APPIAN_HOME>/services/bin_backup
Removing <APPIAN_HOME>/services/lib_backup
Removing the downloaded komodo-1.236.0.zip and its unzipped contents that are in the safe location