[DRAFT SP-9623] Kafka/Zookeeper/Tomcat related data ownership being non-Appian user account prevents services from starting up

Symptoms

Upon starting services, the console output shows the following:

<insert image here>

Inside the server.log, the following error is shown:

[YYYY-MM-DD HH:MM:SS,mmm] ERROR Error while deleting the clean shutdown file in dir <APPIAN_HOME>/services/data/kafka-logs (kafka.server.LogDirFailureChannel)
java.nio.file.AccessDeniedException: <APPIAN_HOME>/services/data/kafka-logs/serviceManager.transaction.<engine>-#/####################.log

<insert more symptoms here>

Cause

Necessary component files are owned by non-Appian user accounts.

Action

To check the file permissions inside the environment, run the following:

1. Check to see if files are owned by different users in Appian_home
   1. sudo find <Appian_home> -printf '%u:%g\n' | sort -t: -u
   2. HA: sudo find -L <Appian_home> -printf '%u:%g\n' | sort -t: -u
2. Change ownership to be under the Appian user
3. Attempt startup
4. If the issue persists, open a support ticket for further investigation.

Affected Versions

This article applies to all self-managed versions of Appian.

Last Reviewed: March 2024