Making a runtime use a different Java version

If your server has multiple versions of Java installed, you can force a runtime to change versions.

About this task

When installing a runtime, Java 8 or 11 is required.

note

Boomi internally tested the latests versions of Amazon Corretto OpenJDK Java and Amazon Corretto Open JDK.

It is recommended that you use the most recent version of Java that supports.

Procedure

1. Make a copy of the inst_jre.cfg file that is located in the <installation_directory>\.install4j directory.

2. Name the new file pref_jre.cfg.

3. Delete the contents of the new pref_jre.cfg file and add the location of the JRE or JDK that the runtime should use.

   Using a Java 8 JRE on a Windows machine looks like this: C:\Program Files\Java\jre8 or C:\Program Files\jdk\jre.

4. Save the file.

5. (For runtime clouds and runtime clusters that are running with MULTI_PROCESS, which enables forked execution) To specify the appropriate system properties in the atom.vmoptions file, do the following :

   1. Go to Manage > Runtime Management.

   2. Select the runtime from the list.

   3. In Settings & Configuration, click Properties, and then click the Advanced tab.

   4. Select the Java Class Path Prepend property (-classpath/p), click Add a Property, and enter the location of the JRE or JDK.

   5. Select the Java Library Path property (-Djava.library.path), click Add a Property, and enter the location of the JRE or JDK.

6. Click Save.

   Because changes to this property do not take effect until the runtime is restarted, you are prompted to restart. You have the option to restart now or restart later.

   After the runtime is restarted, it should now use the version of Java that is in C:\Program Files\Java\jre8 or C:\Program Files\jdk\jre (if you changed it to use Java 8), depending on whether you want to use a JRE or a JDK.