Qlik Talend Products: Java 17 Migration Guide

Brian_Chan — Mon, 13 Apr 2026 11:35:47 GMT

From R2024-05, Java 17 will become the only supported version to start most Talend modules, enforcing the improved security of Java 17 and eliminating concerns about Java's end-of-support for older versions. In 2025, Java 17 will become the only supported version for all operations in Talend modules.

Starting from v2.13, Talend Remote Engine requires Java 17 to run. If some of your artifacts, such as Big Data Jobs, require other Java versions, see Specifying a Java version to run Jobs or Microservices.

Content

Prerequisites

Qlik Talend Module	Patch Level and Version
Studio	Supported from R2023-10 onwards
Remote Engine	2.13 or later
Runtime	8.0.1-R2023-10 or later

Procedure

Multiple JDK versions

When working with software that supports multiple versions of Java, it's important to be able to specify the exact Java version you want to use. This ensures compatibility and consistent behavior across your applications. Here is how you can specify a specific Java version on the following products (such as build servers, shared application server, and similar):

Studio

For Studio users who are using multiple JDKs, please follow the appropriate instructions listed above and follow the proceeding additional steps:

Backup and edit the <Studio Home>\Talend-Studio-win-x86_64.ini file
Prepend:
```
-vm
<JDK17 HOME>\bin\server\jvm.dll
```

Remote Engine

For Remote Engine (RE) users who are using multiple JDKs, please follow the appropriate instructions listed above and follow the proceeding additional steps.

Backup and edit the <RE HOME>/etc/talend-remote-engine-wrapper.conf file
Modify the set.default.JAVA_HOME= property to point to the <JDK 17 HOME> path.

Note 1: If Remote Engine is not installed as a service, the JDK file will be set in the <RE HOME>/bin/setenv file.

Note 2: When it comes to running Jobs or Microservices, you retain the flexibility to either use the default Java 17 version or choose older Java versions, through straightforward configuration of the engine.

How to modify?

Check the following etc folder based configuration and change it to installed jdk/jre path:

{
org.talend.ipaas.rt.dsrunner.cfg--> ms.custom.jre.path
org.talend.remote.jobserver.server.cfg--> org.talend.remote.jobserver.commons.config.JobServerConfiguration.JOB_LAUNCHER_PATH
}

ESB - Runtime

For Runtime users who are using multiple JDKs, please follow the appropriate instructions listed above and follow the proceeding additional steps.

Backup and edit the <Runtime home>/etc/<TALEND-8-CONTAINER service>-wrapper.conf
Modify the set.default.JAVA_HOME=C:\<JDK 17 HOME> path

If Runtime is not running as a service:

Backup and edit the <Runtime home>/bin/setenv.sh
Modify the SET JAVA_HOME= <JDK 17 HOME> path

Studio

Data Integration (DI): After installing the 8.0 R2023-10 Talend Studio monthly update or a later one, if you switch the Java version to 17 and relaunch your Talend Studio with Java 17, you must enable your project settings for Java 17 compatibility.
1. Go to Studio
2. Go to File
3. Edit Project properties
4. Go to Build
5. Go to Java Version
6. Activate "Enable Java 17 compatibility"
  
  With the Enable Java 17 compatibility option activated, any Job built by Talend Studio cannot be executed with Java 8. For this reason, verify the Java environment on your Job execution servers before activating the option.
Big Data Users: Even with the Enable Java 17 compatibility option activated, the Spark Job can still be executed on a Java 8 cluster.

Talend Administration Center (TAC)

To use Talend Administration Center with Java 17, you need to open the <tac_installation_folder>/apache-tomcat/bin/setenv.sh file and add the following commands:

# export modules 
export JAVA_OPTS="$JAVA_OPTS --add-opens=java.base/sun.security.x509=ALL-UNNAMED --add-opens=java.base/sun.security.pkcs=ALL-UNNAMED"

Windows users use <tac_installation_folder>\apache-tomcat\bin\setenv.bat

Talend JobServer

Follow the steps below to configure the JobServer to use the new Java version.

Navigate to the JobServer Configuration:
Go to the <JobServerRootDir>\conf directory, where <JobServerRootDir> is the path to your Talend JobServer installation.
Open the Configuration File for Editing:
Locate the TalendJobServer.properties file and open it with a text editor of your choice.
Set the Java 17 Executable Path:
Find the line dedicated to the Job launcher path within the file. You will modify this line to point to the Java 17 executable.
- For Windows, if your Java installation path contains spaces, ensure to enclose the path in quotes.
```
org.talend.remote.jobserver.commons.config.JobServerConfiguration.JOB_LAUNCHER_PATH="C:\\Program Files\\Java\\jdk-17\\bin\\java.exe"
```
- For Linux or Mac OS, the path doesn’t require quotes.
```
org.talend.remote.jobserver.commons.config.JobServerConfiguration.JOB_LAUNCHER_PATH=/usr/lib/jvm/java-17-openjdk/bin/java
```
Replace the example paths with the actual path where Java 17 is installed on your system. Ensure to point directly to the Java executable within the bin directory of your JDK installation.
Save Your Changes:
After editing, save the TalendJobServer.properties file.
Restart Talend JobServer:
For the changes to take effect, restart your Talend JobServer.

After completing these steps, Talend JobServer will utilize Java 17 for executing Jobs, ensuring compatibility with the latest Java version supported by Talend modules.

CICD

Windows Users

For Java 17 users, Talend CICD process requires the following Maven options:

Backup and edit <Maven_home>\bin\mvn.cmd

Modify to:

set "MAVEN_OPTS=%MAVEN_OPTS% --add-opens=java.base/java.net=ALL-UNNAMED --add-opens=java.base/sun.security.x509=ALL-UNNAMED --add-opens=java.base/sun.security.pkcs=ALL-UNNAMED"

Linux Users

For Java 17 users, Talend CICD process requires the following Maven options:

Backup and edit <Maven_home>/bin/mvn

Modify to:

export MAVEN_OPTS="$MAVEN_OPTS \ 
--add-opens=java.base/java.net=ALL-UNNAMED \ 
--add-opens=java.base/sun.security.x509=ALL-UNNAMED \ 
--add-opens=java.base/sun.security.pkcs=ALL-UNNAMED"

Jenkins Users

Backup and edit the jenkins_pipeline_simple.xml

Include the following in the Talend_CI_RUN_CONFIG parameter:

<name>TALEND_CI_RUN_CONFIG</name>
<description>Define the Maven parameters to be used by the product execution, such as:
    - Studio location
    - debug flags
These parameters will be put to maven 'mavenOpts'.
If Jenkins is using Java 17, add:
--add-opens=java.base/java.net=ALL-UNNAMED --add-opens=java.base/sun.security.x509=ALL-UNNAMED --add-opens=java.base/sun.security.pkcs=ALL-UNNAMED
</description>

Additional Notes

Specifying a Java version to run Jobs or Microservices

Overview

Enable your Remote Engine to run Jobs or Microservices using a specific Java version.

By default, a Remote Engine uses the Java version of its environment to execute Jobs or Microservices. With Remote Engine v2.13 and onwards, Java 17 is mandatory for engine startup. However, when it comes to running Jobs or Microservices, you can specify a different Java version. This feature allows you to use a newer engine version to run the artifacts designed with older Java versions, without the need to rebuild these artifacts, such as the Big Data Jobs, which reply on Java 8 only.

When developing new Jobs or Microservices that do not exclusively rely on Java 8, that is to say, they are not Big Data Jobs, consider building them with the add-opens option to ensure compatibility with Java 17. This option opens the necessary packages for Java 17 compatibility, making your Jobs or Microservices directly runnable on the newer Remote Engine version, without having to go through the procedure explained in this section for defining a specific Java version. For further information about how to use this add-opens option and its limitation, see Setting up Java in Talend Studio.

Procedure

Stop the engine.
Browse to the <RemoteEngineInstallationDirectory>/etc directory.
Depending on the type of the artifacts you need to run with a specific Java version, do the following:

For both artifact types, use backslashes to escape characters specific to a Windows path, such as colons, whitespace, and directory separators, while keeping in mind that directory separators are also backslashes on Windows.

Example:
```
c:\\Program\ Files\\Java\\jdk11.0.18_10\\bin\\java.exe
```
- For Jobs, in the <RemoteEngineInstallationDirectory>/etc/org.talend.remote.jobserver.server.cfg file, add the path to the Java executable file.
  
  Example:
```
org.talend.remote.jobserver.commons.config.JobServerConfiguration.JOB_LAUNCHER_PATH=c:\\jdks\\jdk11.0.18_10\\bin\\java.exe
```
- For Microservices, in the <RemoteEngineInstallationDirectory>/etc/org.talend.ipaas.rt.dsrunner.cfg, add the path to the Java executable file.
  
  Example:
```
ms.custom.jre.path=C\:/Java/jdk/bin
```
  Make this modification before deploying your Microservices to ensure that these changes are correctly taken into account.
Restart the engine.

For Java Option Command --add-opens, using SPACE or = depends on OS, JDK version or the place where you setup, there are 3 cases:
1. support both SPACE and =
2. support SPACE only
3. support = only
Example:
--add-opens=java.base/java.net=ALL-UNNAMED
--add-opens java.base/java.net=ALL-UNNAMED

Re: Qlik Talend Products: Java 17 Migration Guide

wei_guo — Fri, 19 Jul 2024 03:56:12 GMT

Dear Team, @Brian_Chan :
please correct this mvn command syntax error ( = to <SPACE>)

--add-opens=java.base/java.net=ALL-UNNAMED

-->

--add-opens java.base/java.net=ALL-UNNAMED

Re: Qlik Talend Products: Java 17 Migration Guide

Xiaodi_Shi — Mon, 22 Jul 2024 03:10:53 GMT

Hello @wei_guo

Thanks for letting us know this point and about Java option command,

--add-opens

After made an investigation and checked with Qlik Talend R&D team, we added a note into this article for more precise explanation.

Best regards

Sabrina

article Qlik Talend Products: Java 17 Migration Guide in Official Support Articles

Qlik Talend Products: Java 17 Migration Guide

Prerequisites

Procedure

Windows

Linux

MAC OS

Multiple JDK versions

Studio

Remote Engine

ESB - Runtime

Studio

Talend Administration Center (TAC)

Talend JobServer

CICD

Windows Users

Linux Users

Jenkins Users

Additional Notes

Specifying a Java version to run Jobs or Microservices

Re: Qlik Talend Products: Java 17 Migration Guide

Re: Qlik Talend Products: Java 17 Migration Guide