Gateway Java Errors

In order to run Gateway Agents, you'll need to make sure that you have installed the appropriate version the Java SE Development Kit (JDK) installed on your agent's system. Without the right version, JDK 11, you may run into the following error when installing the Gateway Agent on your Windows system.

Error Messages

[2019-11-06 14:47:44] [info] [ 8772] Commons Daemon procrun (1.1.0.0 64-bit) started
[2019-11-06 14:47:44] [info] [ 8772] Service GatewayDemoDomainAgent name GatewayDemoDomainAgent
[2019-11-06 14:47:44] [info] [ 8772] Service 'GatewayDemoDomainAgent' installed
[2019-11-06 14:47:44] [info] [ 8772] Commons Daemon procrun finished
[2019-11-06 14:47:45] [info] [ 1704] Commons Daemon procrun (1.1.0.0 64-bit) started
[2019-11-06 14:47:45] [info] [ 1704] Running 'GatewayDemoDomainAgent' Service...
[2019-11-06 14:47:45] [info] [ 9192] Starting service...
[2019-11-06 14:47:45] [error] [ 9192] Failed creating Java
[2019-11-06 14:47:45] [error] [ 9192] ServiceStart returned 1
[2019-11-06 14:47:45] [info] [ 1704] Run service finished.
[2019-11-06 14:47:45] [info] [ 1704] Commons Daemon procrun finished

Cause

ProcRun has failed to install. ProcRun is a Apache utility which allows us to run java applications as Windows Services. This is caused by either an incompatible version of java or an inability of procrun to verify which version of java is running on the machine.

Resolution

1. Download the OpenJDK 11 from https://adoptium.net/temurin/releases/?version=11 (download the runtime version of java that machines your machine, most likely x64).

2. Extract the downloaded zip file into the windows directory of the agent.

3. Open the Agent EXE file (it will be named after the service that you attempted to create, in this case, it is called GatewayDemoDomainAgent).

4. Once it opens (it may ask for administrator privileges), go to the JAVA tab and select the ... icon to select a java virtual machine.

5. Navigate to the OpenJDK directory in your windows directory and select the server folder followed by jvm.dll - this will tell procrun which JVM version it should be using. 

Please Note: The file path may vary based on the JAVA package.

6. Select the APPLY button.

7. Navigate back to the General tab and select the Start button. The agent should now start running.