Reconfiguring Compass to use a different JRE
When you change the Java Runtime Environment (JRE) for HCL Compass, you must reconfigure the product to make it work with the new JRE.
About this task
Procedure
-
Install the new Java and its JRE.
Note: If in your initial installation of a JRE you installed it in a folder with a folder name that does not identify the version number of the Java (as an example, "jdk" and not "jdk_v8.0"), then you can install the updated Java into the same file system location as the initial Java. If you did not do so at that time, then consider doing that now. No reconfiguration of HCL Compass is necessary when your JRE installation is updated into the previous installation folder.
-
Use any one of the following methods to reconfigure HCL Compass to use the new JRE:
- If you initially installed your JRE with a folder name that did not specify what version of Java, install the updated Java into the same file system location as the initial Java. Then no reconfiguration of HCL Compass is needed. If this method is not applicable, see the next methods.
- Uninstall HCL Compass and then reinstall it. During the re-installation, specify a different JRE path.
- Or, edit the HCL Compass JRE configuration:
- On Linux/UNIX: As super-user, edit the script in
/opt/hcl/compass/java/jre/javawrapper.sh and set the
JRE_ROOT value to the directory containing the java
executable.
For example, if the java executable is installed in /opt/jre-newversion/bin/java, specify
JRE_ROOT="/opt/jre-newversion/bin"
- On Windows: As administrator, edit the Windows registry value:
- HKEY_LOCAL_MACHINE\Software\HCL\Compass\JavaRuntimeDir
The string value is the path to the directory containing the java executable.
For example, if the java executable is installed in C:\Program Files (x86)\jdk8u212-b03\jre\bin\java.exe, specify C:\Program Files (x86)\jdk8u212-b03\jre\bin
- On Linux/UNIX: As super-user, edit the script in
/opt/hcl/compass/java/jre/javawrapper.sh and set the
JRE_ROOT value to the directory containing the java
executable.