Configure the JRE Version

Updating and configuring the Java version on your Groundplex nodes

The Java Runtime Environment (JRE) is a critical component for running Groundplex nodes in SnapLogic. Ensuring that your nodes are using a compatible and secure version of Java is essential for maintaining optimal performance and security. You can use these steps to update the Java version on your Groundplex nodes.

Linux Groundplex installers (RPM and DEB) come bundled with an OpenJDK-based JRE. The May 2026 release adds JRE 17 alongside JRE 11, and the August 2026 release adds JRE 21. Windows Groundplex installers are built to support JRE 17 and JRE 21 but do not bundle a JRE — Java 17 or Java 21 must be installed separately on the host before starting the Snaplex. Learn more.

The bundled JRE is an Eclipse Adoptium Temurin OpenJDK build. The version bundled with the Linux installer is also the minimum supported version for each JRE line:

  • JRE 11: 11.0.31+11
  • JRE 17: 17.0.19+10
  • JRE 21: 21.0.10+7

SnapLogic uses OpenJDK-based builds but does not limit support to a specific OpenJDK distribution. When you install Java separately (in a directory other than the default, or on Windows, which does not bundle a JRE), any compatible OpenJDK-based distribution is acceptable, provided it is a JRE line supported on your platform and meets or exceeds the minimum supported version listed above. Windows supports JRE 17 and JRE 21. For more information, see Support Guide for JRE 17 and JRE 21.

In general, you may need to update the JRE to apply security patches, gain new functionality, or ensure compatibility with your environment.

Important:

The minimum supported version for each JRE line is JRE 11 (11.0.31+11), JRE 17 (17.0.19+10), and JRE 21 (21.0.10+7). These match the versions bundled with the Linux installer. Running a JRE earlier than the minimum for its line is not supported.

JRE version update process

To update the JRE version on your Groundplex node:

  1. Start the upgrade process on your development and testing Orgs.
  2. Verify the functioning of your pipelines in the development Orgs and then update the JRE version on the production Orgs.
  3. Switch the nodes you want to upgrade to Maintenance mode. This ensures that running pipelines complete their execution before the upgrade begins.
Important:
  • When upgrading multiple nodes, we recommend that you upgrade one node at a time.
  • New pipelines are not sent to a JCC node in Maintenance mode.

Update JRE version on Linux

This process updates to JRE 17 or JRE 21 by installing a new SnapLogic RPM/DEB on Linux.

The following image shows the Linux installers, including the JRE 17 and JRE 21 versions.

  1. On the Linux terminal, stop the existing JCC node by running the following command:
    $ sudo /opt/snaplogic/bin/jcc.sh stop
  2. Download and install the new Snaplex installer with JRE 17 or JRE 21. Choose the appropriate installer based on your system and run the corresponding commands:
    Installer Command
    RPM systems $ rpm -U --force <your snaplex file>.rpm
    DEB systems $ dpkg -i <your snaplex file>.deb
    Docker Stop the existing container and start a new container using the latest image.

  3. Start the JCC node by running the following command:

    $ sudo /opt/snaplogic/bin/jcc.sh start.

  4. The Snaplex will start with the JRE (JRE 17 or JRE 21) bundled along with the SnapLogic installer.
  5. To update to a JRE 17 or JRE 21 installed at another location, create a file /etc/sysconfig/jcc with SL_JAVA_HOME pointing to the desired JRE location. Run the following command to create the file:
    sudo mkdir -p /etc/sysconfig; sudo sh -c "echo 'export SL_JAVA_HOME=/opt/snaplogic/pkgs/jdk-21-jre/' >> /etc/sysconfig/jcc"
    Note: Change SL_JAVA_HOME in the above command to point to the custom JRE 17 or JRE 21 location as needed (for example, jdk-17-jre or jdk-21-jre).

Update JRE version on Windows

The Windows installers support JRE 17 and JRE 21. Unlike the Linux RPM/DEB installers, the Windows installer does not bundle a JRE. Java 17 or Java 21 must be installed separately on the host before starting the Snaplex. The following image shows the JRE 17 Windows installers highlighted as an example.

To update to JRE 17 or JRE 21 on Windows:

  1. In the Windows command prompt, stop the JCC node by running the following command:
    c:\opt\snaplogic\bin\jcc.bat stop
    Note: This step is required only when an existing Snaplex installation is present on the node
  2. Download the new installer Zip and extract the contents to the following location:
    c:\opt\snaplogic
  3. Download and install Adoptium's OpenJDK-based Java installer for the version you want to run: Java 17 or Java 21.
  4. Update the c:\opt\snaplogic\bin\jcc.bat file and update the JAVA_HOME to point to the location of the Java 17 or Java 21 installation.
  5. Start the JCC nodes:
    1. If you are running the Snaplex as a service, run the following commands:

      jcc.bat remove_service

      jcc.bat install_service

    2. Run the following command:

      c:\opt\snaplogic\bin\jcc.bat start

  6. After you configure Java, go to the SnapLogic Monitor and verify if the Additional details tab displays the Java version as 17 or 21.