Configure the Java version on your Groundplex
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. 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.
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.
- 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 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:
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. -
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
withSL_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: ChangeSL_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 theJAVA_HOME
to point to the location of the Java 11 installation. - Start the JCC nodes:
- If you are running the Snaplex as a service, run the following commands:
jcc.bat remove_service
jcc.bat install_service
- Run the following command:
c:\opt\snaplogic\bin\jcc.bat start
- If you are running the Snaplex as a service, run the following commands:
- 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.