How to switch from Oracle to OpenJDK Java Runtime Environment
This article describes the steps required to replace Oracle Java Runtime Environment (JRE) to the OpenJDK equivalent. The download links point to the Adoptium OpenJDK (formerly Adopt OpenJDK) binaries.
Step 1 - Verify your Verba version and check the supported Java version and download the OpenJDK runtime as follows:
Verba version | Java version | Download link |
---|---|---|
8.x | Java SE 8 Runtime Environment 32 bit | https://adoptium.net/releases.html?variant=openjdk8&jvmVariant=hotspot Choose the
|
9.0, 9.1 and 9.2 | Java SE 8 Runtime Environment 64 bit | https://adoptium.net/releases.html?variant=openjdk8&jvmVariant=hotspot Choose the
|
9.3 or later | Java SE 11 Runtime Environment 64 bit | https://adoptium.net/releases.html?variant=openjdk11&jvmVariant=hotspot Choose the
|
Step 2 - Copy the downloaded OpenJDK package (msi) to the Verba server and install it using the following command-line command:
msiexec /i [OpenJDK_installer.msi] INSTALLLEVEL=2
Step 3 - Check the JAVA_HOME variable in a new command line window using the command::
echo %JAVA_HOME%
You should see the path to your OpenJDK installation.
Step 4 - Change the following Windows Registry setting:
HKLM\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\VerbaWebApp\Parameters\Java\Jvm
to
Verba 8.x | C:\Program Files\Eclipse Adoptium\jre-[version]-hotspot\bin\server\jvm.dll |
Verba 9.x | C:\Program Files\Eclipse Adoptium\jre-[version]-hotspot\bin\server\jvm.dll |
Change the [version] part to the actual folder name!
Step 5 - Restart all Verba services using Java:
- Verba Cisco JTAPI Service
- Verba Avaya DMCC/JTAPI Service
- Verba Web Application Service
- Verba Cisco Central Silent Monitoring Service
- Verba Cisco Compliance Service
- Verba Cloud Compliance Service
Step 6 - Verify functionality by making tests covering your basic use cases.
Rolling back changes
In case the system does not work properly after switching to OpenJDK or you want to continue using Oracle JRE, follow the steps below to roll back the changes:
Step 1 - Verify that you have Oracle JRE still installed on the Verba server. If not, install the required Oracle JRE depending on the Verba version.
Step 2 - Change the JAVA_HOME and PATH variables back to the original values pointing to the Oracle JRE installation.
Step 3 - Change the HKLM\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\VerbaWebApp\Parameters\Java\Jvm registry setting back to 'auto'.
Step 4 - Restart all Java services using Java.