KB-1548 Cannot run program "jps" error when starting Service Manager

Symptoms

When executing a Service Manager script in the <APPIAN_HOME>/services/bin directory, one of the following errors are returned:

  • Exception thrown while attempting to retrieve process info for java process with main Class name QuorumPeerMain. java.io.IOException: Cannot run program "jps": error=2, No such file or directory
    ...
    Caused by: java.io.IOException: error=2, No such file or directory
  • Exception thrown while attempting to retrieve process info for java process with main Class name QuorumPeerMain. java.io.IOException: Cannot run program "jps": error=13, Permission denied

Cause

There are several possible causes for this issue.

  1. If you are using Oracle Java, this error is returned when the JAVA_HOME path is set to JRE, rather than JDK. As per the Appian System Requirements, JDK is the supported option. To check the JAVA_HOME variable:
    • In Windows, right click My Computer and select Properties. On the Advanced tab, select Environment Variables, and edit JAVA_HOME to view the JDK path.
    • In Linux, type echo $JAVA_HOME in a terminal to view the Java path.
  2. If you are using OpenJDK, the basic download of OpenJDK does not ship with JPS.
  3. An external program, such an antivirus software, kills the Service Manager script before the Appian services start.

Action

  1. To resolve the issue, follow the Appian Installation Prerequisites documentation to set up the JAVA_HOME and PATH variables to point to the JDK. If using OpenJDK, ensure that the developer edition is being used.
  2. Ensure the Appian user has appropriate permissions to run jps command.
  3. Ensure external programs do not interfere with the Appian startup.

Affected Versions

This article applies to Appian 17.3 and later.

Last Reviewed: March 2022

Related
Recommended