Upgrading OpenJDK

Introduction

Oracle announced the End of Public update for Oracle Java SE 8. Commercial users will not receive further updates after January 2019.

AppsAnywhere will continue to support our Cloudpaging Server product and has determined that replacing OracleJDK with OpenJDK is the best solution. This article will walk you through the steps to switch existing Cloudpaging Server environments to start using OpenJDK.

• Customers should complete this process internally

• It is recommended to upgrade Cloudpaging Server to the Latest Release before upgrading OpenJDK as that version will be compatible with the newer versions of OpenJDK.

Manual upgrade

Obtain OpenJDK community build

A build of OpenJDK be downloaded from Latest Releases | Adoptium.

Ensure the OpenJDK build number is the same as the version compatible with the release of Cloudpaging Server.

For example, if Cloudpaging Server installs with jdk8u342-b07.1, it is recommended to upgrade to the latest stable patch that has been released for OpenJDK version 8 e.g. jdk8u372-b07. 

Install OpenJDK

OpenJDK must be manually installed and configured to all servers running Cloudpaging Server. Follow the steps below to install OpenJDK using an installer.

1. Run the downloaded installer.

   Accept the EULA

   Install OpenJDK Runtime. OpenJFX Runtime and Web Start are not needed for Cloudpaging Server. If you change the install location, then make sure to note it as you will need it in the later step.

   

   Continue by clicking on Next, then Install. Finally, complete the install by clicking on Finish.

Update Cloudpaging Server

Once OpenJDK has been installed, Cloudpaging Server configuration must be updated to use the installed OpenJDK instead of OracleJDK provided with the Cloudpaging Server installer. 

There is a registry script attached to this article to update the configuration automatically if you installed the OpenJDK 1.8.0.191 using the link provided above, and installed to the default location. Otherwise, follow the steps below to update the JVM configurations. 

Warning: A restart of Cloudpaging Server is required for these steps. Be careful when applying these changes to a production system.

Important: The following steps require you to modify the Windows registry. Make sure that you back up the registry before you modify it. Make sure that you know how to restore the registry if a problem occurs.

1. Open Registry Editor and navigate to the following path:

   1. 64-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\JukeboxServer\Parameters\Java

   2. 32-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\JukeboxServer\Parameters\Java

2. Edit the following registry value:
   Name: JVM

   Type: REG_SZ

   Data: <path to the OpenJDK install location>\jre\bin\server\jvm.dll

   (example: C:\Program Files (x86)\ojdkbuild\java-1.8.0-openjdk-1.8.0.191-1\jre\bin\server\jvm.dll)

   

3. Then, navigate to the following path:

   1. 64-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\JukeboxServer\Parameters\Start

   2. 32-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\JukeboxServer\Parameters\Start

4. Edit the following registry value:
   Name: WorkingPath

   Type: REG_SZ

   Data: <path to the OpenJDK install location >\jre\bin

   (example: C:\Program Files (x86)\ojdkbuild\java-1.8.0-openjdk-1.8.0.191-1\jre\bin)

   

5. Restart Cloudpaging Server by using Services MMC

Verify that Cloudpaging Server is using OpenJDK

To verify that Cloudpaging Server is using OpenJDK, take a look at core_service.log file located in <Cloudpaging Server installation directory>\core\logs\core_service.log (The default location is C:\Program Files (x86)\Numecent\Application Jukebox Server\core\logs).

You should see the following lines if you have successfully configured to use OpenJDK.

• Configuration: java.runtime.version: <OpenJDK version> (example: 1.8.0_191-1-ojdkbuild-b12)

• Configuration: java.home: <path to the OpenJDK install location>\jre (example: C:\Program Files (x86)\ojdkbuild\java-1.8.0-openjdk-1.8.0.191-1\jre)

Previous versions of Java will need to be removed manually.

This procedure can be completed by AppsAnywhere by submitting a Support request.