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, the following error is 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

Cause

There are two possible causes for this issue.

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.
If you are using OpenJDK, the basic download of OpenJDK does not ship with JPS.

Action

To resolve the issue, follow the Appian documentation on setting up the JAVA_HOME and PATH variables to point to the JDK. If using OpenJDK, ensure that the developer edition is being used.

Affected Versions

This article applies to Appian 17.3 and later.

Last Reviewed: February 2019