Note: Please make sure that the new Java version is supported with the specific OpenEdge version. Refer to the Product Availability and Life Cycle Guide for more details:
Post-install, the Java vendor can be changed or Java patch level can be upgraded, as long as you stay within the supported Minor version (JDK 11.0 not 14.0)
Java patches of a certified version of Java will be supported by default. This policy is based on assumption that Java patches do not alter any existing behavior or functionality. Should an issue arise we will provide technical support when customers are using a more-current patch release. With our certification on OpenJDK, this will cover any vendors offering i.e. we will support any OpenJDK version commercially available with the caveat that if there is an issue we need to be able to reproduce it on the version of OpenJDK that we certified on. In general we expect that any new release of OpenJDK is fully tested by the provider.
12.1 and later
OpenEdge 12.1 and later are no longer ship with Java, which means you have to install the certified version before running the OpenEdge Install.
After you have installed OpenEdge the current configuration needs to be upgraded to reflect the change. The full instructions are provided :
Note: As of 11/19/2025, the doc above is missing key information regarding the OEM step involving the proant command, until it is fixed follow the steps below instead:
Stop both the adminserver and OEM services under Windows or if using command line:
proadsv -stop
fathom -stop
update the %DLC%\properties\java.properties with the updated jdk as JAVA_HOME=<jdk_path>
In a proenv shell run:
fathom -unregister
fathom -register
Restart the AdminServer and OEM.
In OpenEdge Versions 12.0, 11.x, 10.x
Before upgrading the shipped version, please refer to the following Article:
To change the Java version for an OpenEdge installation on Windows:
Install the required 32-bit or 64-bit Java as instructed by the vendor. Make a backup of the current %DLC%\jre and %DLC%\jdk directories and delete their content.
Method 1: Update the Registry
- Stop all OpenEdge processes.
- Open the Windows Registry Editor (regedit).
- Change the path for the each of the following properties to point to the new JDK:
JDKCP, JDKHOME, JRECP and JREHOME
- HKEY_LOCAL_MACHINE\SOFTWARE\PSC\PROGRESS\<ver>\JAVA
- HKEY_CURRENT_USER\Software\PSC\PROGRESS\x64\<ver>\JAVA
Note: In the case of a 32-bit OpenEdge installation on a 64-bit Windows the registry key is:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\PSC\PROGRESS\<ver>\JAVA
Method 2: Copy the required java install to the current DLC installed java
- Make a backup of the current %DLC%\jre and %DLC%\jdk directories and delete their content.
- Copy the jdk and jre directories from the required Java installation.
- Paste them to the %DLC% directory overwriting the old ones.
Additional Considerations:
OpenEdge Explorer or OpenEdge Management:
- %DLC%/properties/JavaTools.properties file, change the path for "tools.jar"
PDSOE:
- %DLC%\oeide\eclipse\eclipse.ini, change the value of the -vm argument to the location of the javaw.exe
- %DLC%\oeide\integrateArchitect.bat, update the new location to the Java location. (set JAVA=)
