You are currently reviewing an older revision of this page.

SP-4042 KB - XXXX Engines fail to start following hotfix deployment or upgrade to Appian versions 19.2 - 19.4

Symptoms

Appian Engines fail to start following a hotfix deployment or version upgrade.

Cause

This is due to a bad Service Manager version on 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:

  1. Unzip the file provided by Appian Support into a safe location that is not <APPIAN_HOME>.
  2. Shutdown all components of Appian gracefully
  3. Rename <APPIAN_HOME>/services/bin to <APPIAN_HOME>/services/bin_backup
  4. Rename <APPIAN_HOME>/services/lib to <APPIAN_HOME>/services/lib_backup
  5. From the unzipped download, copy the ‘bin’ directory into <APPIAN_HOME>/services
  6. From the unzipped download, copy the ‘lib’ directory into <APPIAN_HOME>/services
  7. Start Service Manager, ZooKeeper, and Kafka on all engine nodes using <APPIAN_HOME>/services/start.bat|sh -p PASSWORD -s all
  8. Stop Service Manager, ZooKeeper and Kafka on all engine nodes using <APPIAN_HOME>/services/stop.bat|sh -p PASSWORD -s all
  9. Start Appian normally using the steps provided in our Starting and Stopping Appian documentation

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:

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

Affected Versions

This article applies to 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