We need to update the version of OpenJDK that Clarity is using

Products

• Clarity PPM On Premise

Issue/Introduction

Per our Security team, I had two versions on Java running, the latest and and old version. I needed to uninstall the older version. After I uninstalled the old version, I could no longer access Clarity

When I looked on the servers, I see that there are 4 services not running.

How can I change the version of OpenJDK?

Environment

Release : 16.0.2, 16.0.1, 16.0, 15.9.3, 15.9.2, 15.9.1, 15.9, 15.8.x

Resolution

Our steps to change which version of OpenJDK that Clarity will use are:

(if needed) Install the desired version of OpenJDK . You should check the release notes for your version of Clarity to assure the version of Java you want is compatible. You can download the latest version of OpenJDK here:

https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot

Note: The version you install must the same Version family that is supported for the version of Clarity you are using. The JVM type should be "HotSpot"

1. Locate the home folder for the new version of Java JDK. We found 2 different ways to do this from a command prompt window. We’re looking for the folder name up to, but not including /bin/java.exe
   
   1. The Windows “dir /b/s java.exe” command
   2. The Windows “java -XshowSettings:properties -version” command
2. Update the JAVA_HOME system environment variable.
   1. From Windows File Explorer right click on “My PC” and select “Properties”
   2. Click on “Advanced System Settings”
   3. Click on “Environment Variables”
   4. In the lower “System Variables” list locate the “JAVA_HOME” environment variable. Highlight it and click “Edit”.
   5. Change the value to be the new home folder for Java.
   6. To save and close click “OK” and then close the System properties window.
3. Update the %CAPPM_HOME%\config\properties.xml file
   1. (if needed) Locate the folder where Clarity is installed with the “echo %CAPPM_HOME%” command.
   2. From Windows File Explorer navigate to the folder where CA PPM is installed. (In our case we found it at D:\CA\CAPPM.)
   3. Inside the “config” folder locate a file named “properties.xml” and edit this file with Notepad.
   4. Locate the line that begins with “<java home=…” and change the value for java home to the new home folder for Java.
   5. Save and close the file.
4. (Stop if needed and) restart the Clarity services.
   1. (if needed) Close the command prompt window and open a new one so that it reflects the updated JAVA_HOME environment variable setting.
   2. Execute the “service stop start all” command to stop and restart the services.

Note: If the service command on step 4 is not successful and throws the following message "'java' is not recognized as an internal or external command....", download and install the jdk again and repeat the steps 3-5.