Java Distribution Update

The installer updates the JDK for all INUBIT and Portal components.

The new JDK installation is located in the _jvm folder. The previous JDK installation is located in the \_jvm_backup_<jdk-version> folder.

After the Update

Drivers, etc.

Copy all required drivers from the previous JDK directory to the new JDK directory. This applies, for example, to the SAP library (sapjco3.dll or libsapjco3.so).
Certificates

A new version of the cacerts file is located in the new JDK directory.

ATTENTION: If you copy the previous cacerts file directly into the new JDK folder, there is a risk of losing standard certificates newly added to the JDK installation.

Therefore, manually add the required certificates to the new cacerts file.
Linking

In the java_home_path_setter.[sh|cmd] file, the entry for JAVA_HOME points to the newly added JDK installation folder.

Java Version Check

The script java_home_path_setter.[sh|cmd] contains the following line:

set JAVA_MAJOR_VERSION_REQUIRED=<required Java version>

This allows the application to check upon startup whether the currently used JDK meets the required Java version. If you use the Java distribution provided with the installation, no adjustments are necessary. If you use a custom Java distribution, the JDK must satisfy the major version specified here.

Using a custom JDK

You can use a JDK distribution or version other than the one provided with the installer.

The major version of the JDK must match; otherwise, error-free execution of the application cannot be guaranteed. See installation-guide:system-requirements.adoc#jdk_version

Procedure

Stop the Process Engine.
Open the file <SUITE-INSTALL-DIR>/inubit/java_home_path_setter.[sh|cmd]
Change the path in the line starting with "JAVA_HOME=".

The path must point to the folder containing the installed Java distribution on the system.
Default: JAVA_HOME environment variable
Save the changes.
Start the Process Engine.