WA Agent 12.1 fails to start with Java 21: "The JRE version in use is not supported"
search cancel

WA Agent 12.1 fails to start with Java 21: "The JRE version in use is not supported"

book

Article ID: 430594

calendar_today

Updated On:

Products

Workload Automation Agent ESP dSeries Workload Automation - System Agent (dSeries) ESP dSeries Workload Automation - Business Agents (dSeries)

Issue/Introduction

When attempting to run the Workload Automation (WA) Agent version 12.1 using IBM Semeru Runtime (OpenJDK) 21, the agent fails to initialize. The agent logs indicate that the Java version is incompatible, and the shutdown sequence is initiated immediately.

Error message in cybagent_service log:

02/18/2026 15:38:24.075-0500: The JRE version in use is not supported. Please install the supported JRE version.
02/18/2026 15:38:24.090-0500: CybAgentDriver has exited
02/18/2026 15:38:24.106-0500: Initiating shutdown sequence...
02/18/2026 15:38:24.121-0500: Shutdown sequence complete

Environment

Workload Automation Agent 12.1

Cause

Workload Automation Agent 12.1 is designed to run exclusively on Java 8 (JRE 1.8). The agent's internal version check prevents it from starting on newer Major Java releases such as Java 21, which was not supported at the time version 12.1 was released.

Resolution

To resolve this issue, you must either downgrade the Java version used by the Agent or upgrade the Agent itself to a version compatible with Java 21.

Option 1: Use a Supported JRE for Agent 12.1

If you must remain on Agent version 12.1, you must point the agent to a JRE 1.8 installation.

  1. Install JRE 1.8 (64-bit).

  2. Edit the agentparm.txt file in the agent installation directory.

  3. Update the oscomponent.javapath to point to the directory of the JRE 1.8 installation.

  4. Restart the agent.

Option 2: Upgrade the Agent (Recommended for Java 21)

Support for newer Java versions was introduced in subsequent releases. To use Java 21, you must upgrade to at least version 24.0.

JRE Support Matrix by Agent Version:

  • Agent 12.1: Requires JRE 1.8 only.

  • Agent 12.1.1: Supports JRE 1.8, Java 11, or Java 17.

  • Agent 24.0 & 24.1: Supports JRE 1.8, Java 11, Java 17, or Java 21.

Additional Information

 

  • When upgrading the agent, ensure that any utilized Plugin Extensions (POJOs) are also updated to versions compatible with the new Agent release and Java version.

  • Consult the Workload Automation Agent 12.1 documentation for supported Java versions.

 

Powered by Wolken Software