Pairing Remote Engines with the configuration file - Cloud

Talend Remote Engine User Guide for Windows
Version
Cloud
Language
English
Operating system
Windows
Product
Talend Cloud
Module
Talend Remote Engine
Content
Design and Development
Installation and Upgrade
Last publication date
2023-11-16

Pair a Remote Engine by configuring the Remote Engine settings on your local machine.

If you have installed the Remote Engine using the installer and already defined the Remote Engine key during the installation process, this configuration file is already set up. You can ignore this section.

Before you begin

  • You have installed the Remote Engine.
  • You have created a Remote Engine in Talend Cloud Management Console.

Procedure

  1. Open Talend Cloud Management Console.
  2. Open the Processing page then click the Engines tab.
  3. Select the environment of the engine from the Environment drop-down-list.
    You can also use the search box and the filter options to filter the list.
  4. On the engine list, click the remote engine you want to pair to open its Engine details blade.
  5. Click Installation.
  6. From the Remote Engine key field, copy the preauthorized key (also referred to as pre-authorized or pre-authorization key).
    This pre-authorization key is used as the remote engine pairing key in your remote engine configuration.
  7. If started, stop the Remote Engine by executing the stop.bat file in the <RemoteEngineInstallationDirectory>/bin folder.
  8. Open <RemoteEngineInstallationDirectory>/etc/preauthorized.key.cfg.
  9. Edit the parameters.
    remote.engine.pre.authorized.key
    Paste the preauthorized key. This pre-authorization key is the remote engine paring key.
    remote.engine.name
    Enter the name of the Remote Engine.
    remote.engine.description
    Enter the description of the Remote Engine.
  10. Save the file.
  11. Launch the Talend Remote Engine console on your machine ( trun.bat).
  12. Type list then press Enter .
    All bundles are in Active status.

Results

Your remote engine has been paired with your account and the status moved to Paired on Talend Cloud Management Console.

To run tasks with the Remote Engine as the execution runtime, ensure that you have the Execute right on the workspace where the engine is located.

Troubleshooting:
If you encounter the error message below in your engine's Karaf logs, it means that engine pairing has failed: 
Error setting property: PropertyDescriptor <name: cleanInterval, getter: null, setter: [class org.talend.ipaas.rt.deployment.agent.impl.KarafDataMavenCleaner.setCleanInterval(long)]
This error is caused by trailing spaces at the end of the local.maven.clean.interval.days parameter line in the <RemoteEngineInstallationDirectory>/etc/org.talend.ipaas.rt.deployment.agent.cfg file.
  • 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.

To resolve the issue, remove the trailing spaces from the local.maven.clean.interval.days parameter line.