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

book

Article ID: 141393

calendar_today

Updated On:

Products

CLARITY PPM FOR ITG 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 Java SE Development Kit * Update 172 (version 8.0.1720.11). 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.. 

Environment

Release : 15.4.1

Component : ACTUATE ISERVER FOR CA CLARITY PPM

Resolution

Our steps to change which version of Java CA PPM will use are:

  1. (if needed) Install the desired version of Java JDK (not JRE). You should check the release notes for your version of CA PPM to assure the version of Java you want is compatible.
  2. 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
  3. 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.
  4. Update the %CAPPM_HOME%\config\properties.xml file
    1. (if needed) Locate the folder where CA PPM 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.
  5. (Stop if needed and) restart the CA PPM 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 5 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.