Configuring the Java Version on your Groundplex

In this article

Overview

You can follow the instructions in this document to configure Java 11 on your Linux and Windows Snaplex instances. Starting with the 4.24 release (February 2021), Snaplex instances on Java 8 will stop working.  

Java Version Configurability

When you install a Groundplex using the new RPM/DEB installer or a Docker container, it defaults to Java 11. While we ship Java 11 with the Snaplex for Linux users, Windows users must manually update to Java 11.  

Existing Customizations on Linux/Windows

  • For existing custom Groundplex instances, you must reapply the customizations after upgrading to Java 11.
  • To use custom truststore entries, you should back up the /opt/snaplogic/pkgs/jre1.8.0_162/lib/security/cacerts file and copy any additional custom truststore entries to the /opt/snaplogic/pkgs/jdk-11.0.8+10-jre/lib/security/cacerts file using the keytool utility. 

Rolling Back your Version of Java

As of the 4.24 release (February 2021), we do not support rolling back to Java 8.

Upgrade Process

To upgrade your Groundplex to Java 11:

  1. Start the upgrade on the development and testing Orgs.
  2. Verify the functioning of your Pipelines in the development Orgs and then upgrade the production Orgs to Java 11.
  3. Switch the nodes that you want to upgrade into Maintenance mode. This allows running Pipelines to complete execution before the upgrade starts.
  • When upgrading multiple nodes, we recommend you to upgrade one node at a time.
  • New Pipelines are not sent to the JCC node in Maintenance mode.

Configuring Java 11 on Linux

To switch existing nodes to OpenJDK Java 11:

  1. On the Linux terminal, stop the existing JCC node by running the following command:
    $ sudo /opt/snaplogic/bin/jcc.sh stop

  2. Download the new Snaplex installer and install the Groundplex, running the RPM, DEB, or Docker installers as appropriate.
    • For RPM systems, run the following command:
      rpm -U --force snaplogic-snaplex.rpm
    • For DEB systems, run  the following command:
      dpkg -i snaplogic-snaplex.deb
    • For 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.

The installation folder has two packages for Java 11 and Java 8 (in case a rollback is required). 

Configuring a custom JRE version

The Snaplex installer defaults to openjdk-11.0.8+10-jre. To change the version, create a file /etc/sysconfig/jcc with SL_JAVA_HOME pointing to the desired JRE location.

To create the /etc/sysconfig directory and /etc/sysconfig/jcc file as well as grant read permissions to all users, run the following command:

sudo mkdir -p /etc/sysconfig; sudo sh -c "echo 'export SL_JAVA_HOME=/opt/snaplogic/pkgs/jdk-11.0.8+10-jre/' >> /etc/sysconfig/jcc"


Configuring Java 11 on Windows

To switch to Java 11 on Windows: 

  1. In the Windows command prompt, stop the JCC node by running the following command:
    c:\opt\snaplogic\bin\jcc.bat stop
    This step is required if there is an existing Snaplex installation on the node.

  2. Download the new installer Zip and extract the contents to the following location:
     c:\opt\snaplogic

  3. Download and install the OpenJDK-based Java 11 installer.

  4. Update the c:\opt\snaplogic\bin\jcc.bat file and update the JAVA_HOME to point to the location of the Java 11 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

After you configure Java, go to the SnapLogic Dashboard and verify that the Additional Information dropdown list displays the Java version as 11.0.8 or higher.

Support Plan

Java 8 is no longer supported. Snaplex nodes running Java 8 will fail to upgrade to the 4.24 release (February 2021), and an error will appear in the jcc_ouptut.log. All nodes must be upgraded to Java 11 for your Snaplex instances to upgrade successfully.

Java 11 Support FAQs 

How is Java 11 supported in the SnapLogic Platform?

The current Snaplex Linux installers have a bundled JRE 11 distribution, and Groundplex instances are installed with JRE 11.

Is Java 8 still supported?

No. Java 8 is deprecated as of August 2020. Java 8 is no longer supported for the 4.24 Release (February 2021).