Installing and configuring your Talend Remote Engine

author
Talend Documentation Team
EnrichVersion
6.5
EnrichProdName
Talend Integration Cloud
task
Installation and Upgrade
EnrichPlatform
Talend Remote Engine

Installing and configuring your Talend Remote Engine

Talend Remote Engine, which allows you to run Flows in on-premises containers, is provided to you as the following packages :

  • The Talend-RemoteEngine-VA.B.C-Linux-x64.run executable file allows you to install the Remote Engine automatically.

  • The Talend-RemoteEngine-VA.B.C-MacOSX.tar.gz executable file allows you to install the Remote Engine automatically.

  • The Talend-RemoteEngine-VA.B.C-Windows.exe executable file allows you to install the Remote Engine automatically.

    If you install Talend Remote Engine via Talend Integration Cloud Installer, the related Windows service is installed by default.

  • The Talend-RemoteEngine-VA.B.C.tar.gz archive file allows you to install Talend Remote Engine manually.

  • The Talend-RemoteEngine-VA.B.C.zip archive file allows you to install Talend Remote Engine manually.

Once you have installed Talend Remote Engine, you need to pair it with the Talend Integration Cloud web application.

For more information on Talend Remote Engine and how to use it and pair it with Talend Integration Cloud using a web service or a configuration file, see Working with Remote Engines.

Install Talend Remote Engine

Before you begin

Ensure that you have set the JAVA_HOME environment variable.

Procedure

  1. From the Admin page in the Talend Integration Cloud web application, add a Remote Engine and assign it to the personal workspace of the user or to the shared Workspace.

    An authorized key is automatically generated. You will need this key during the installation process. For further information, see Creating Remote Engines.

    It is recommended that you start the installation procedure by adding the Remote Engine as it is the only way to generate the authorized key you will need during the installation. Also, the number of Remote Engines you can create is limited according to your license. This way you make sure if you still have the right to add a new remote Engine early in the process.

  2. From the Admin page or the User Settings page in the web application, download the Talend Integration Cloud Installer executable files for automatic installation, or the Archive file for manual installation.
  3. Either:
    • Use the executable files to install Talend Remote Engine automatically.

      Run the installer as administrator and follow the installation process: Talend Remote Engine will be unzipped in the Talend Remote Engine installation directory at the end of the process.

      Make sure to provide the authorized key during the installation process in order to pair Talend Remote Engine automatically. If not, you can always copy-paste the Key generated in the Talend Integration Cloud web application in the Remote Engine Key field of the Remote Engine Configuration page.

      For more information on how to generate the Remote Engine Key in the Talend Integration Cloud web application, see Working with Remote Engines.

    • Copy the archive file to a directory of your choice and unzip it. For more information on how to pair it with the Talend Integration Cloud web application, see Working with Remote Engines.

Set up the SAP connectors for Talend Remote Engine

In order to create Actions that use some SAP connectors in the Talend Integration Cloud web application and the Talend Studio, you need to set up these connectors both in the Studio and in the Remote Engine.

For more information on how to set up SAP in the Studio, see Setting up a remote connection in Talend Studio.

For more information on how to install the SAP RFC server that is necessary to receive IDoc documents from the SAP server and make them available for processing in Talend Jobs, see Installing and configuring Talend SAP RFC Server.

Procedure

  1. Before launching Talend Remote Engine, please follow the procedure described in the README.txt file delivered in the <RemoteEngineInstallationDirectory>/add-ons/datasources/sap folder.
  2. Before launching Talend Remote Engine, please follow the procedure described in the README.txt file delivered in the <RemoteEngineInstallationDirectory>\add-ons\datasources\sap folder.

Enable remote access using HTTP (optional)

If you want to access remotely to Talend Remote Engine using HTTP, you need to edit a configuration file.

Procedure

Open the <RemoteEngineInstallationDirectory>/etc/org.ops4j.pax.web.cfg file to edit it.
By default, the org.ops4j.pax.web.listening.addresses value is set to localhost,127.0.0.1, change it to 0.0.0.0 then save your changes.

Results

You are now allowed to connect to Talend Remote Engine from other machines using HTTP.

Enable remote access using SSH (optional)

If you want to access remotely to Talend Remote Engine using SSH, you need to edit a configuration file.

Procedure

Open the <RemoteEngineInstallationDirectory>/etc/org.apache.karaf.shell.cfg file to edit it.
By default, the sshPort value is set to localhost, change it to 0.0.0.0 then save your changes.

Results

You are now allowed to connect to Talend Remote Engine from other machines using SSH.

Enable remote access using JMX (optional)

If you want to access remotely to Talend Remote Engine using JMX, you need to edit a configuration file.

Procedure

Open the <RemoteEngineInstallationDirectory>/etc/org.apache.karaf.management.cfg file to edit it.
By default, the rmiRegistryHost and rmiServerHost values are set to localhost, change them to 0.0.0.0 then save your changes.

Results

You are now allowed to connect to Talend Remote Engine from other machines using JMX.

Start Talend Remote Engine

Procedure

  1. Launch the karaf.batkaraf executable file from the <RemoteEngineInstallationDirectory>/bin folder.
  2. Launch the karaf.bat executable file from the <RemoteEngineInstallationDirectory>\bin folder.

Results

Apache Karaf is started and the console displays Talend-RE.

Once Talend Remote Engine is configured, you need to pair it with Talend Integration Cloud using a web service or a configuration file. For more information, see Working with Remote Engines.