Skip to main content
Feedback

Using a JDK to upgrade to Boomi's latest supported version of Java 8

Use the Boomi upgrader to upgrade your runtime to a newer version of Java 8.

Before you begin

This topic does not contain reversion instructions. Instead, it instructs you about how to upgrade your runtimes from an older version of Java 8 to Boomi's newest supported version. See the topic Java upgrade FAQ for more information on how to revert a Java version.

Before you begin, ensure that you download the Amazon Corretto Java 8 JDK to your local drive. You can download the custom JDK from here. When downloading a custom Java 8 JDK, you must use a version Boomi currently supports. You are also responsible for any security updates you might need for your JDK until you upgrade your runtime to the latest Java Version.

Currently, the Java 8 upgrader is available for 64-bit machines only.

About this task

Though Boomi highly recommends that you upgrade your runtime to the newest supported version of Java 11 (11.0.20.8.1), you have the option to upgrade your runtime containers to run on the newest supported version of Java 8 without needing to fully upgrade to 11. Be aware that if you choose to keep your runtime containers on Java 8, Boomi no longer provides Java security updates to containers running on Java 8.

When you download and run the upgrade wizard to upgrade your runtime to a new version of Java, the wizard gives you the option (Step 11 of these instructions) to use either the Boomi-provided JDK or your own managed Java JDK from which your runtime runs. Suppose you choose to use the Boomi-provided JDK. In that case, the full JDK automatically downloads to your local directory, and your runtime updates to use the newest version of Java 8. However, choosing your own external JDK allows you to select and use your own distributed version of Java 8 JDK in which your upgraded runtime will run.

Use the following steps to upgrade your runtime to Java 8:

Procedure

  1. Ensure that you have the Java 8 JDK downloaded onto your local drive. For details, see the Before you begin section of this topic.

  2. In the user interface, navigate to Manage > Runtime Management.

  3. Select the runtime from the list that you want to upgrade.

  4. From the Runtime Information panel, click Update to use Java <version number>.

    The upgrader file is automatically downloaded to your local drive (likely your Downloads folder). The file name is atom_upgrade64.exe or similar.

  5. Click Save File.

  6. Before you run the upgrader, ensure that you stop all runtime cluster or runtime cloud nodes.

    The upgrade to Java 8 requires changes to the executable file. For security reasons, Windows prevents running executables from being modified. If runtime cluster or runtime cloud nodes are kept running, the upgrade fails.

  7. Locate the upgrader file on your local drive and run the executable file.

    The upgrade wizard opens.

    • If you are using Windows or the Linux GUI, run the file and follow the wizard to complete the required steps.

    • For Linux, if you want to run the installer in console mode from a command line, run the file with the -c flag:

      sh /<path>/cloud_upgrade64.sh -c

      Follow the prompts, which take you to step 8.

  8. On the Welcome to the Upgrade Wizard screen, click Next.

  9. On the Select the Directory Containing the <Runtime, runtime cluster, or Cloud> screen, click Browse to find the folder on your local drive where your selected runtime was originally installed.

    For example, the installation directory for "User Cloud" is at C:\Program Files\Boomi AtomSphere\Cloud - User Cloud. It may be helpful to use the folder search feature to search on the name of your runtime. If the Browse field automatically points to the correct file path, proceed to the next step.

    • If you are using Windows or the Linux GUI, on the Select the Directory Containing the <Runtime, runtime cluster, or Cloud> page click Browse, locate and select the directory in which the runtime is installed, then click Next.

    • If you are using the Linux command line, type the path to the runtime's original installation directory. Make sure the upgrade program completes successfully, then skip to the last step.

  10. On the Select the Directory Containing the <Runtime, runtime cluster, or Cloud> screen, click Next.

  11. On the Choose the installation directory JRE or an external JDK page, select Use external JDK for preferred JRE from the following options:

    • Switch the preferred JRE to Runtime Installation's JRE directory updates your runtime with Boomi's latest version of Java and changes the location in the pref_jre.cfg file. The pref_jre.cfg file contains the path to the JRE that the runtime will use/

    • Do not make changes to the preferred JRE updates your runtime with Boomi's latest version of Java but does not change the location in the pref_jre.cfg file. The pref_jre.cfg file contains the path to the JRE that the runtime uses currently.

    • Use external JDK for preferred JRE uses a custom distributed version of Amazon Corretto 8. Click Browse next to Specify the external JDK location and locate the folder of the external JDK that you want to use.

    note

    For Switch the preferred JRE to Runtime Installation's JRE directory and Do not make changes to the preferred JRE, if the runtime is currently using the JRE directory, the new Java version is downloaded into the jre_a (previously named jre_backup) folder, otherwise the new Java version is downloaded into the JRE directory.

  12. Click Next.

  13. On the Migrate Certificates screen, do one of the following:

    • If you do not want to migrate custom certificates automatically, click Next without making changes.

    • If you want to migrate custom certificates automatically, turn on the Migrate existing custom certificates automatically box and click Browse to locate the folder containing the JDK that your runtime is using. Then, click Next.

  14. The wizard begins upgrading your selected runtime according to the preferences you have set earlier in this topic. When the wizard completes successfully, click Finish.

Results

Your runtime is now successfully upgraded to a newer version of Java 8. To see that the upgrade is successful, view the Java Version field in Manage > Runtime Management > Startup Properties panel for your selected runtime.

On this Page