Skip to main content
Documentation
Documentation
Adaptive Planning
Last Updated: 2023-06-23
Swap from Oracle JDK to OpenJDK for Data Agents

Swap from Oracle JDK to OpenJDK for Data Agents

You can swap from the Oracle JDK to an OpenJDK (Azul Zulu JDK) without uninstalling your Data Agent. Swapping from Oracle can help you avoid the licensing fees associated with using the Oracle JDK. Before 2024R1, by default, the Data Agent installer installed the Oracle JRE if it didn't detect a valid JDK on your system.
We strongly recommend the Azul Zulu OpenJDK Azul Zulu OpenJDK Download.

  • Verify the Workday Adaptive Planning Data Agent 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

Navigation Icon5.png These steps take place on your local computer.

Swap the JDK for the Workday Adaptive Planning Data Agent Manager

To swap the JDK and continue using your existing data agents:
  1. Stop the
    Adaptive AgentService
     in the Windows Services Manager.
  2. Close the
    Data Agent Service Manager
     and the
    Adaptive Script Editor
    .
  3. Uninstall the Oracle JRE/JDK and restart your computer.
  4. Download and install an OpenJDK (.msi or .exe).
  5. Make sure you select these OpenJDK installation options in Custom Setup in the installation wizard:
    • JAVA_HOME
    • JAR Files Association
    • Registry
    OpenJDK Installation Options
  6. Complete the installation.
  7. Restart your computer.
  8. Open the Workday Adaptive Planning Data Agent Manager and verify your existing Data Agents started.
Troubleshoot Opening Workday Adaptive Planning Data Agent Manager v7.1.44
If Data Agent version 7.1.44 will not open after you swap the JDK:
  1. Right click on Data Agent Service Manager in the Windows start menu.
  2. 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
    .
  3. Right click on Data Agent Service Manager in the file explorer and select
    Properties
    .
  4. 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
    ".
  5. Select
    Apply
     and
    OK
    .