Skip to main content
Feedback

Updating a runtime on Java 8 to use Amazon Corretto

Use the “Update Java Provider to Corretto” link on the Runtime Information panel to quickly update your runtimes running on Java 8 from Oracle to Amazon Corretto.

About this task

Boomi supports the Amazon Corretto JDK distribution, so we recommend that you update your runtime from Oracle to avoid licensing concerns when applying your own security patches. Users with runtime containers on Amazon Corretto Java 8 are responsible for updating containers with their own security updates until they upgrade them to the latest version of Java that Boomi supports.

note

This feature does not upgrade your runtime to Java 11 and is available only for 32- and 64-bit containers on Windows and 64-bit containers on Linux.

Procedure

  1. Click on Manage > Runtime Management, and select the runtime you want to update.

  2. In the Runtime Information panel, click the "Update Java Provider to Corretto" link.

    note

    This link appears only if the runtime is on Java 8 and does not already use the supported Amazon Corretto Java provider.

    For Windows users, the update wizard file (atom_corretto_upgrade.exe), downloads to your local drive. For Linux users, the update wizard file (CONTAINER_corretto8_upgrade64.sh) downloads to your local drive.

  3. Locate and run the atom_corretto_upgrade.exe (Windows) or CONTAINER_corretto8_upgrade64.sh (Linux) file on your local drive.

    Windows users might encounter a unknown publisher security warning. If you encounter this warning, click Run to proceed with the update.

  4. In Welcome, click Next.

  5. In Select the Directory Containing the Runtime, verify that the folder directory is correct for the runtime you want to upgrade or click Browse to locate and select the directory for the correct runtime. Then, click Next.

  6. On the Choose the installation directory JRE or an external JDK page, select one of the following:

    • Switch the preferred JRE to Runtime Installation's JRE directory to change the location of the runtime's pref_jre.cfg file to the installation's JRE directory

    • Do not make changes to the preferred JRE updates the runtime installation's JRE directory with the latest version of Java, but does not change the location of the pref_jre.cfg file from its existing directory location.

      note

      If the prev_jre.cfg file points to the jre_a (previously named jre_backup) directory, the file changes to redirect to the runtime installation's JRE directory instead.

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

  7. Click Next.

  8. (Optional) In Migrate Certificates, optionally migrate certificates from your current JVM to the new one the runtime uses after the update. Do one of the following:

    • To migrate certificates, turn on the Migrate existing custom certificates automatically, and then click Browse to locate and select the directory that contains the existing JVM. Then, click Next.

    • If you do not want to migrate certificates, click Next without making any selections. The update wizard completes and your runtime updates to use the Amazon Corretto Java provider.

    The update wizard completes and your runtime updates to use the Amazon Corretto Java provider.

Results

When the update finishes successfully, the Runtime Information Panel in Runtime Management does not show the link "Update Java Provider to Corretto" for the updated runtime. The Startup Properties panel updates the Java Version and Java Home fields to the new Java version and directory location, respectively.

On this Page