Process Automation - How to verify, upgrade or change the Java JDK used

book

Article ID: 39011

calendar_today

Updated On:

Products

CA Process Automation Base Process Automation Manager

Issue/Introduction

Need to verify the release of JDK that is being used in PAM, and potentially update the Java JDK that Process Automation is using.

Cause

The PAM functionality retains its JDK configuration in file c2osvcw.conf, c2osvcd.sh on *unix systems.  A default PAM install will have this config file located under C:\Program Files\CA\PAM\server\c2o\bin\

The following two lines from c2osvcw.conf (c2osvcd.sh on *unix systems) show entries that indicate that the Orchestrator is starting using the 1.8.0 81 Java JDK version.

wrapper.java.command=c:/program files/java/jdk1.8.0_81/bin/java
wrapper.java.classpath.2=c:/program files/java/jdk1.8.0_81/lib/tools.jar

Environment

Process Automation 4.3.x

Resolution

To change the Java version being used by the Orchestartor:

1.  Stop CA Process Automation Orchestrator

2.  Install JDK acquired from Java.com 

3.  Update the CA\PAM\server\c2o\bin\c2osvcw.conf (c2osvcd.sh on *unix systems) file to point at the newly installed JDK, commenting out the existing lines to use as a reference:

#wrapper.java.command=C:/program files/java/jdk1.8.0_81/bin/java
wrapper.java.command=C:/program files/java/jdk1.8.0_192/bin/java

#wrapper.java.classpath.2=C:/program files/java/jdk1.8.0_81/lib/tools.jar
wrapper.java.classpath.2=C:/program files/java/jdk1.8.0_192/lib/tools.jar

4.  Start CA Process Automation Orchestrator.
Once Process Automation is verified as working using the new Java the commented lines can be removed without the need to restart the Orchestrator.

 

Alternatively, the latest release of Process Automation, 4.3 sp5, supports AdoptOpenJDK an open source Java release:
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/intelligent-automation/automic-process-automation/04-3-05/installing/prerequisites/domain-orchestrator-and-orchestrator-prerequisites/jdk-prerequisites.html

The JDK lines in the c2osvc would look similar to:

wrapper.java.command=c:/program files/adoptopenjdk/jdk-8.0.222.10-openj9/bin/java
wrapper.java.classpath.2=c:/program files/adoptopenjdk/jdk-8.0.222.10-openj9/lib/tools.jar

Please note, there are different versions of the AdoptOpenJDK so your AdoptOpenJDK jdbc lines may vary slightly.
 
 
 
 

Additional Information

- Please be aware that all versions of Process Automation exhibit issues using any Oracle Java newer than 1.8.0_192 due to changes Oracle has made.  
See KB 139723 Java Compatibility with IT Process Automation for details. 

ORACLE 8 JDK: 
Due to changes Oracle made to the security within the Java starting with JDK 1.8.0_202 IT Process Automation has issues when attempting to run using any JDK newer than the 1.8.0_192 JDK.  Issues include installation failures, multiple startup issues, agent connectivity problems, and other issues of varying levels of severity.   

For 4.3 sp1 through 4.3 sp5 the most current ORACLE JDK that has not shown issues is1.8.0_192.


AdoptOpenJDK:
Starting with 4.3 Sp5 we have introduced support for AdoptOpenJDK: JDK Prerequisites Documentation

For 4.3 Sp5 we have confirmed up to AdoptOpenJDK version 1.8.0_265 allows the software to function without issue

 

Uninstalling the original Java is recommended best practice, but if the Java major version number is changing - for instance from 1.7 to 1.8 - you must uninstall the older version.