Skip to main content

Remote Engine configuration files

This document presents the Remote Engine configuration files that are most relevant to daily usage of your engine.
Configuration files Description
/etc/keystores

Remote Engine generates its own key pair (RSA/4096 bits) during the pairing process. With Talend Remote Engine v2.12.5 onwards, this key pair is stored in a Java keystore in etc/keystores, secured with a password defined in a dedicated configuration file or as an environment variable.

If no password is defined, a random value is generated instead to ensure that the private key is still stored encrypted at rest.

This pair of keys is used to protect the information transferred between Talend Remote Engine and Talend Management Console.

/etc/org.apache.karaf.management.cfg Activate JMX access to Remote Engine. See Remote access with JMX.
/etc/org.apache.karaf.shell.cfg Activate SSH access to Remote Engine. See Remote access with SSH.
/etc/org.ops4j.pax.logging.cfg and /tec/org.talend.ipaas.rt.logs.cfg
/etc/org.ops4j.pax.web.cfg
  • Add org.osgi.service.http.enabled = false to prevent the Remote Engine from listening on port 8043 (HTTP) and use the secure Remote Engine port instead (9004).

    For further information about how to access this port using trusted client certificate, see Creating trusted client certificate.

  • Enable remote access to Remote Engine from other machines. See Remote access to Remote Engine.
/etc/org.talend.ipaas.rt.deployment.agent.cfg This file stores the artifact deployment parameters.
  • The local.maven.clean.interval.days parameter controls automatic cleanup of unused artifacts in your engine. For further information about your Remote Engine's resilience settings, see Automatic artifact cleanup.
  • Set maximum number of parallel runs on a single engine or a engine cluster. For further information about parallel runs on a Remote Engine, see Running tasks in parallel.
  • Set up a regular cleanup process to automatically delete unused artifacts. See

/etc/org.talend.ipaas.rt.dsrunner.cfg

/etc/org.talend.ipaas.rt.dsrunner.talendruntime.client.cfg Define credentials to secure the access to Talend Runtime.
/etc/org.talend.ipaas.rt.keypair.manager.cfg Define your own password to replace the random one to encrypt and secure the access to the keystore. This requires engine unpairing and the removal of the previously generated key pairs and keystores for that pairing.

For further information about how to define your own password to encrypt the keystore, see Securing keystores to access Remote Engine.

/etc/org.talend.ipaas.rt.job.commandline.handler.cfg Add the stdout and the stderr logs of your Job executions to the Log4j logs to display the information in Talend Management Console

See Display standard system logs in Talend Management Console.

/etc/org.talend.ipaas.rt.jobserver.client.cfg
/etc/org.talend.remote.jobserver.server.cfg This file contains the parameters for configuring the JobServer embedded in the engine, which executes data integration tasks. The settings you can define or update include: You can find an exhaustive list of the parameters and read their documentation in the configuration file itself.
/etc/preauthorized.key.cfg This file stores the remote engine pairing key, that is to say, the pre-authorization key and the description of the engine to be paired.

For further information about how to pair your engine using this file, see Pairing Remote Engines with the configuration file.

/etc/system.properties
  • Activate graceful reboot. See Graceful reboot on Linux.
  • Add the client configuration and the server configuration of your JobServer to separate files to establish an SSL connection between the JobServer server and the JobServer client inside a Remote Engine. The client configuration should be added to this /etc/system.properties file, while the server configuration should be added to /etc/org.talend.remote.jobserver.server.cfg.

    For further information about SSL connection in a Remote Engine, see Activating SSL connection.

  • Configure proxy settings for a Remote Engine. See Proxy settings for Remote Engines and Proxy authentication.
/etc/talend-remote-engine-wrapper.conf This configuration file serves as a wrapper, based on the Karaf wrapper configuration file. This file enables the integration of the engine in your operating system as a service. For this reason, it is available only when you have installed your Remote Engine as a Windows service or a Linux service. If you have not done so and need guidance on installation, see for Windows or for Linux.

In this file, if necessary, define the specific system environment properties to be used by the engine. For example:

  • In the JVM parameters section of this wrapper file, specify the JVM settings to be used by the engine. Note that these JVM settings determine the resources to be allocated to the engine as a service, while the JVM settings defined in a Run profile in Talend Management Console refer to the resources allocated to that specific execution.
  • If the Job to be run on a Remote Engine relies on third-party tools, such as an SDK, or MelissaData, specify the paths to these tools in this Remote Engine wrapper configuration file using the following format:
    set.PATH=<PATH_TO_SDK>;%PATH%
    This line informs the engine about the location to the third-party tool while retaining the existing content of the PATH environment variable. For further information, see Enabling the execution of Jobs using external tools (SDK).
/etc/users.properties The default security configuration uses a property file located at <RemoteEngineInstallationDirectory>/etc/users.properties to store authorized users and their passwords.

For further information, see Managing Remote Engine users and passwords.

/TalendJobServersFiles A Remote Engine needs to access Job task dependencies such as the Job artifacts, the logs and the working folders stored in a folder called TalendJobServersFiles. When you deploy multiple engines, ensure that each Remote Engine instance has its separate TalendJobServersFiles folder.

For further information about how to deploy multiple engines, see Deploying multiple engines.

/TalendJobServersFiles/jobexecutions/logs/

Logs of the task runs are stored in this directory.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!