Customizing global OSGi configuration - Cloud

Talend Remote Engine User Guide for Windows

Operating system
Talend Cloud
Talend Remote Engine
Design and Development
Installation and Upgrade
Last publication date
This configuration is used to connect Remote Engine to Talend Runtime and deploy bundles to Talend Runtime.


  • Edit the org.talend.ipaas.rt.dsrunner.cfg file to deploy bundles to Talend Runtime.
    1. To set a custom deployment directory, change the value of the osgi.execution.folder property. The default value is <RemoteEngineInstallationDirectory>/data/dsrunner/exec/osgi.
    2. To set a custom Talend Runtime directory, change the value of the osgi.talend.runtime.folder property. The default value is /opt/talend/runtime.
  • Edit the org.talend.ipaas.rt.dsrunner.talendruntime.client.cfg file to configure the connection from Remote Engine to Talend Runtime.
    1. Among the properties, it is mandatory to define your JMX username and password. Possible options include:
      • Set the RUNTIME_JMX_USERNAME and RUNTIME_JMX_PASSWORD environment variables.
      • Define the RUNTIME_JMX_USERNAME and RUNTIME_JMX_PASSWORD Java System properties.
      • Replace the default expressions of talendruntime.jmx.username and talendruntime.jmx.password with the actual values you need to use.
    2. Set a custom JMX URL by editing the talendruntime.jmx.url property, if you do not want to use the default one, which is
    3. Encrypt sensitive property values. To do this,
      1. Wrap the strings to be encrypted in ENC(). For example, talendruntime.jmx.password=ENC(your_password_string).
      2. In the environment configuration file, runtime_installation/bin/setenv.bat, add the following line to set the TESB_ENV_PASSWORD environment variable to specify the encryption password or secret:
        SET TESB_ENV_PASSWORD=your_encryption_password

        For more details about this encryption setting, see Encrypting parameters and passwords.

    By default, most of the properties in this file are resolved as references to environment variables or as Java System variables if the respective environment variables are not set. This behavior is achieved when a property is declared using the following syntax: talendruntime.jmx.username=${env:RUNTIME_JMX_USERNAME:-${RUNTIME_JMX_USERNAME}}, which has the following meaning:
    1. An environment variable named RUNTIME_JMX_USERNAME is searched for, and if present, is used.
    2. If no environment variable named RUNTIME_JMX_USERNAME is present, a Java System variable of the same name is searched for, and if present, is used.