Skip to main content Skip to complementary content
Qlik Resources
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal

Troubleshooting: Re-pairing a Remote Engine

Restore the connection between an already-paired Remote Engine and Talend Management Console when reinstalling is not feasible.

The recommended way to restore a pairing is to reinstall the Remote Engine. Use this task only when a full re-installation is not possible.

Before you begin

  • You have already paired the Remote Engine once before.
  • You have the Infrastructure Administrator role in Talend Management Console.

Procedure

Obtain a new preauthorization key

  1. Retrieve a new preauthorization key from Talend Management Console.

    • From the Talend Management Console Web UI:

      1. Open Talend Management Console.
      2. Open the Processing page, then click the Engines tab.
      3. Select the environment of your engine from the Environment drop-down list.
      4. On the engine list, click the Remote Engine that you need to re-pair.
      5. In the Engine details blade, click the Manage tab.
      6. Click Reset the key in the Reset the connection section.
        Screenshot of the information window about resetting a Remote Engine pairing key.
      7. Follow the wizard to generate and copy the new preauthorization key.

    • From the Talend Management Console API:

      You can create a Remote Engine entity and retrieve its preauthorization key programmatically. See Creating and pairing a Remote Engine programmatically.

Prepare the engine for re-pairing

  1. Stop the engine gracefully.

    For instructions on stopping the engine gracefully, see Running the graceful shutdown process of Remote Engine.

  2. In <RemoteEngineInstallationDirectory>/etc/org.talend.ipaas.rt.pairing.agent.cfg, remove the value of the remote.engine.id property.
  3. Delete the <RemoteEngineInstallationDirectory>/data/cache directory.

Re-pair the engine

  1. Choose one of the following methods to re-pair your engine.

    • Using the web configuration interface:

      1. Launch the Talend Remote Engine console on your machine (trun.bat).
      2. In a browser, open http://localhost:8043/configuration.
      3. Paste the new preauthorization key in the key field.
      4. Enter your deployment region if prompted.
      5. Click Pair Remote Engine.
      6. In the engine console, type list then press Enter.
      7. All bundles display as Active when re-pairing is successful.

    • Using the configuration file:

      Use this method for headless or CLI-only environments. The engine must remain stopped while you edit the file.

      1. In <RemoteEngineInstallationDirectory>/etc/preauthorized.key.cfg, update the remote.engine.pre.authorized.key property with the new preauthorization key.
      2. Start the engine by launching the Talend Remote Engine console (trun.bat).
      3. In the engine console, type list then press Enter.
      4. All bundles display as Active when re-pairing is successful.

Results

Your Remote Engine is now paired. The status updates to Paired in Talend Management Console.

To run tasks with this engine, ensure you have the Operator (Execute) right on the space where the engine is located.

If you need to know the Java version used by the engine, click the Configuration tab in the Engine details blade. There you can see the version Talend Remote Engine is using for start and also the Java version it uses to run tasks and plans. Note that by default, Talend Remote Engine uses the Java it starts with to run tasks and plans.

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 – please let us know!

Leave your feedback here