Replacing Oracle Java with AdoptOpenJDK

Replacing Oracle Java with AdoptOpenJDK

Overview

This document outlines the steps to replace Oracle Java with AdoptOpenJDK.  AdoptOpenJDK is an open source software which can be utilized in leu of a licensed Oracle Java platform.

Steps:

  1. Login with Administrator permissions to the FAM server on which Elasticsearch is installed.
    • If you are unsure where Elasticsearch is installed –

Login to the Admin Client

Click Health Center from the Navigation menu

Select the Infrastructure tab

Click on File Access Manager Elasticsearch

In the details page, the Server Name will be listed

  1. Stop the Elasticsearch service

Open services.msc

Navigate File Access Manager Elasticsearch 5.1.1

barbara_hodgkin_0-1619539275052.png

Click Stop

  1. Uninstall Java 8

Open Windows “Programs and Features” (Control Panel\Programs\Programs and Features)

Select Java 8

Right click > Uninstall

  1. Download AdoptOpenJDK

Go to https://adoptopenjdk.net/

Click on “Other platforms”

Choose version OpenJDK 8 (LTS)

Download the latest OpenJDK8 x64 JRE archive(*.zip) for your proper platform

  1. Unzip the content to some folder (i.e “C:\Program Files\AdoptOpenJDK”)
  2. Set your JAVA_HOME variable

Open an elevated command line and run the following command:

setx -m JAVA_HOME "[UNZIP_LOCATION]"

The output should state SUCCESS: Specified value was saved

NOTE: Make sure the [UNZIP_LOCATION] points to the location where the “bin” and “lib” folders are. For example, the [UNZIP_LOCATION] is “C:\Program Files\AdoptOpenJDK\OpenJDK8U-jre_x64_windows_openj9_8u292b10_openj9-0.26.0\jdk8u292-b10-jre”:
Folder Content.PNG

You can verify it was set properly by navigating to Environment Variables and validate the Value has been reset

  1. State new registry keys

Using Notepad, create a new text file with .reg extension and save to your desired location

Paste the following (make sure to replace UNZIP_LOCATION with the correct value)

Windows Registry Editor Version 5.00 

[HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft]

 [HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment]

"CurrentVersion"="1.8"

[HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\1.8]

"JavaHome"="UNZIP_LOCATION"

            Ex. "JavaHome"="C:\Program Files\AdoptOpenJDK"

"RuntimeLib"="UNZIP_LOCATION\\bin\\server\\jvm.dll"

            Ex. "RuntimeLib"="C:\Program Files\AdoptOpenJDK\OpenJDK8U-jre_x64_windows_openj9_8u292b10_openj9-0.26.0\jdk8u292-b10-jre\bin\server\jvm.dll"

 

  1. Run the new file - this will import the registry keys.

Double-click on the file to run

or

Open an elevated command line

Change directories to the location of the saved .reg file created in the step above

I.e. cd [location of file]

Enter the name of the saved registry file including extension and hit enter

Ie [nameoffile].reg

This should prompt a message from the Registry Editor

barbara_hodgkin_1-1619539275057.png

Click Yes

A confirmation should then appear:

barbara_hodgkin_2-1619539275060.png

Click OK  

  1. Start the Elasticsearch service and verify there are no error in the Dashboard / Activity Forensics

 

Troubleshooting:

Elasticsearch service is not starting:

  • Navigate to the Elasticsearch Log files (generally: C:\Program Files\SailPoint\Logs\elasticsearch)
  • Open elasticsearch-service-x64.{date}
  • If you see: [error] [ 8620] Failed creating java
  • In the Windows search, type regedit, click enter – this should open your Registry Editor
  • Navigate to HKEY_LOCAL_MACHINE > Software > JavaSoft > Java Runtime Environment
  • Ensure you see CurrentVersion
  • If not, go ahead and manually add it
  • Right-click on Java Runtime Environment > New > String Value
    1.      Name = CurrentVersion, Data = 1.8
  • Navigate to  HKEY_LOCAL_MACHINE > Software > JavaSoft > Java Runtime Environment > 1.8
  • Ensure you see two values JavaHome and RuntimeLib
  • If you do not see them, go ahead and manually add them
  • Right-click on the 1.8 folder > New > String Value
    1.      Name = JavaHome, Data = UNZIP_LOCATION
    2.      Name = RuntimeLib, Data = jmv.dll location (ie: C:\Program Files\AdoptOpenJDK\OpenJDK8U-jre_x64_windows_openj9_8u292b10_openj9-0.26.0\jdk8u292-b10-jre\bin\server\jvm.dll)
  • Retry starting the service

 

Labels (2)
Version history
Revision #:
2 of 2
Last update:
‎May 20, 2021 05:59 PM
Updated by:
 
Contributors