How to define alternative JRE when instaling CA Release Automation Agent

Document ID : KB000004628
Last Modified Date : 14/02/2018
Show Technical Document Details
Issue:

In some environments, such as ones that utilize IBM JRE/JDK for example, the agent does not come bundled with a JRE, and the systems java version may be too old, or not the intended build to avoid running 'Legacy OS' actions.

Environment:
Operating System: Any supported UNIX/Linux OSDatabase: N/AVersion(s): Any supported version (5.0+), must NOT have a bundled JRE in the installer.
Cause:

In some environments, such as ones that utilize IBM JRE/JDK as just one example, eg: AIX.  Others out there include Solaris, HP-UX, more. The agent utilized by these operating systems do not come bundled with a JRE, and rely on solely the systems java version by default, which may be too old, or not the intended build, as we want to inevitably avoid running 'Legacy OS' actions only, which occurs when utilizing a JRE older than version 7.

Resolution:

When installing the agent, you must utilize an installer which does not include a JRE bundled with the deployer/agent, for example:

nolio_agent_6_2_0_b3010.sh

Little known secret, install4j has a parameter, that, when used in conjunction with installers that lack a bundled JRE, will point the agent to an arbitrary JRE of your choice, typically JRE7 or newer.

 

The solution is as easy as knowing where the JRE is installed that you intend to use, then defining the environment variable:

'INSTALL4J_JAVA_HOME_OVERRIDE'

Depending on the operating system, or more specifically the shell being used, this can vary.  For example, with bash you may simply execute:

Bash:

export INSTALL4J_JAVA_HOME_OVERRIDE=/path/to/desired/jre -- followed by executing the installer ( ./nolio_agent_6_2_0_b3010.sh )

ksh:

setenv INSTALL4J_JAVA_HOME_OVERRIDE=/path/to/desire/jre -- then execute the installer ( ./nolio_agent_6_2_0_b3010.sh )

 

You should then end up with a working agent installation with the preferred java version.

Additional Information:

Please contact CA Support for any assistance needed 24/7/365.