Swap from Oracle JDK to OpenJDK for Data Agents

Last updated
Save as PDF

Explains how to swap from Oracle JDK to OpenJDK for Data Agents.

You can swap from the Oracle JDK to an OpenJDK without uninstalling your Data Agent. Swapping from Oracle can help you avoid the licensing fees associated with using the Oracle JDK. By default, the Data Agent installer will install the Oracle JRE if it does not detect a valid JDK on your system.

Several organizations provide OpenJDK build downloads, including:

AdoptOpenJDK
- https://adoptopenjdk.net/
- https://adoptopenjdk.net/migration.html
Amazon Corretto
- https://aws.amazon.com/corretto/
RedHat OpenJDK
- https://developers.redhat.com/products/openjdk/download
- https://developers.redhat.com/blog/2018/11/05/migrating-from-oracle-jdk-to-openjdk-on-red-hat-enterprise-linux-what-you-need-to-know/

Prerequisites

Verify the Data Agent Service Manager v7.1.44 or newer is installed on your local computer.
Verify you have local rights on your computer to install OpenJDK.
Make a note of your Data Agent Service Manager version.
Download a 64-bit OpenJDK build for use with Pentaho Kettle.

Navigation

These steps take place on your local computer.

Swap the JDK for Data Agent Service Manager

To swap the JDK and continue using your existing data agents:

Stop the Adaptive AgentService in the Windows Services Manager.

Close the Data Agent Service Manager and the Adaptive Script Editor.

Uninstall the Oracle JRE/JDK and restart your computer.
Download and install an OpenJDK (.msi or .exe).
Make sure you select these OpenJDK installation options in Custom Setup in the installation wizard:

JAVA_HOME
JAR Files Association
Registry

OpenJDK Installation Options

Complete the installation.
Restart your computer.
Open the Data Agent Service Manager and verify your existing Data Agents started.

Troubleshoot Opening Data Agent Service Manager v7.1.44

If Data Agent version 7.1.44 will not open after you swap the JDK:

Right click on Data Agent Service Manager in the Windows start menu.
Select More > Open file location and select C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Workday Adaptive Planning Data Agent. For data agent versions 7.1.44 and older select C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Adaptive Data Agent.
Right click on Data Agent Service Manager in the file explorer and select Properties.
Change the Target value to indicate the location of the new OpenJDK you installed. This target path to your javaw.exe will vary based on your OpenJDK installation location. Example: If you installed the RedHat OpenJDK, you would indicate: "C:\Program Files\RedHat\java-1.8.0-openjdk-1.8.0.232-3\bin\javaw.exe" -jar "C:\Program Files\Workday Adaptive Planning Data Agent\AgentManager-1.0.0.jar" . For older versions you would indicate, "C:\Program Files\RedHat\java-1.8.0-openjdk-1.8.0.232-3\bin\javaw.exe" -jar "C:\Program Files\Adaptive Data Agent\AgentManager-1.0.0.jar".
Select Apply and OK.