Configure the Java version on your Groundplex

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. Following are the steps for updating and configuring the Java version on your Groundplex nodes.

SnapLogic Groundplex nodes come bundled with an OpenJDK-based JRE 11 distribution. However, you may need to update the JRE to apply security patches, gain new functionality, or ensure compatibility with your environment.

Note: SnapLogic supports only Java 11-based distributions. Java 8 or earlier versions are not supported.

JRE version update process

To update the JRE version on your Groundplex node:

Start the upgrade process on your development and testing Orgs.
Verify the functioning of your Pipelines in the development Orgs and then update the JRE version on the production Orgs.
Switch the nodes you want to upgrade to Maintenance mode. This ensures that running pipelines complete their execution before the upgrade begins.

Note:

When upgrading multiple nodes, we recommend that you upgrade one node at a time.
New Pipelines are not sent to the JCC node in Maintenance mode.

Update JRE version on Linux

This process updates the JRE version by installing a new SnapLogic RPM/DEB on Linux

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

Download and install the new Snaplex installer: Choose the appropriate installer based on your system and run the corresponding commands:



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.

Start the JCC node by running the following command:

$ sudo /opt/snaplogic/bin/jcc.sh start.
The Snaplex will start with the JRE bundled along with the SnapLogic installer.
The Snaplex installer defaults to openjdk-11.0.12+7-jre.
To update to a JRE 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 files and grand read permissions to all users:
```
sudo mkdir -p /etc/sysconfig; sudo sh -c "echo 'export SL_JAVA_HOME=/opt/snaplogic/pkgs/jdk-11.0.12+7-jre/' >> /etc/sysconfig/jcc"
```
Note: Change SL_JAVA_HOME in the above command to point to the custom JRE location as needed.

Update Java on Windows

To update the Java version on Windows:

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
Download the new installer Zip and extract the contents to the following location:
```
c:\opt\snaplogic
```
Download and install the Adoptium's OpenJDK-based Java 11 installer.
Update the c:\opt\snaplogic\bin\jcc.bat file and update the JAVA_HOME to point to the location of the Java 11 installation.
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 if the Additional Information dropdown list displays the Java version as 11.0.12+7 or higher.