# Upgrading Talend Remote Engine

Available in...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform

Follow this procedure to upgrade your Talend Remote Engine if you are not using Data Services and Routes, or if you are using them with an older version of Talend Remote Engine.

## Before you begin

Before upgrading, check the support status of your target version in [Talend Remote Engine lifecycle](https://help.qlik.com/talend/en-US/customer-support-statements/Cloud/talend-remote-engine-lifecyle).

* * Available in:
  * Cloud API Services Platform
  * Cloud Data Fabric
* If you are using Data Services and Routes running on Talend Runtime, make sure you are using the latest version of Talend Runtime. If you are not, you should upgrade Talend Runtime before upgrading Talend Remote Engine. For more information, see [Manual migration of a full Talend Runtime installation](https://help.qlik.com/talend/en-US/installation-guide-linux/Cloud/manual-migration-of-a-full-talend-runtime-installation "Some versions of Talend Runtime, such as 8.0.1-R2023-08-RT and 8.0.1-R2025-02-RT, cannot be obtained from a patch nor be migrated automatically. Therefore, these versions must be installed manually from scratch.").
  * Available in:
  * Cloud API Services Platform
  * Cloud Data Fabric
* If you need to upgrade Remote Engine v2.11.8 onwards for data service Job or Route tasks, see [Upgrading Remote Engine v2.11.8 onwards for Data Services and Routes tasks](https://help.qlik.com/talend/en-US/installation-guide-linux/Cloud/upgrading-remote-engine-for-esb-tasks "Upgrade your Remote Engine without the need to undeploy or redeploy any data service Job or Route tasks currently running on the engine.") to complete the upgrade without the need to undeploy or redeploy any Data Services and Routes tasks currently running on the engine.

## About this task

When upgrading to a new version of Talend Remote Engine, you can pair the new version of the engine with your account, replacing the previous one in the app. This enables Talend Management Console to retain the execution runtime settings for all tasks set to execute with the Remote Engine as you are installing the new version.

## Procedure

1. * Available in:
   * Cloud API Services Platform
   * Cloud Data Fabric

   If Data Services and Routes tasks are running on your current Talend Remote Engine, list them to make it easier to redeploy them after the upgrade.
2. Confirm that there are no Jobs running on your current Talend Remote Engine.
3. Stop the current Talend Remote Engine service and application.

   Any process still running on the Talend Remote Engine at this point is automatically terminated.
4. Step into the <RemoteEngineInstallationDirectory> directory and uninstall the application by running uninstall.

   Ensure that none of the Remote Engine files are open when starting the process.
5. Make sure that the <RemoteEngineInstallationDirectory> directory and its contents have been completely removed from your drive.
6. Open Talend Management Console.
7. Open the Processing page then click the Engines tab.
8. 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.
9. On the engine list, click the Remote Engine you want to upgrade. Its Engine details panel is displayed.
10. Click Manage and Reset key.

    A wizard is displayed to start the resetting process of pairing key for this Remote Engine.
    ### Example

    ![Dialog box where users can reset the pairing key of their Talend Remote Engine.](https://help.qlik.com/talend/en-US/installation-guide-linux/Resources/images/tmc-repair_re.png)
11. Click Reset key to confirm the resetting.

    A new Remote Engine key is generated that you can copy from the Pairing key field.
12. The new key is displayed in the Manage tab of the Engine details blade. If you have not downloaded the new engine version, click the Download link in this tab to open the Downloads page and then download the latest version of the Talend Remote Engine installer.
13. Run the installer as root user as explained in [Installing the Remote Engine automatically](https://help.qlik.com/talend/en-US/installation-guide-linux/Cloud/installing-remote-engine-automatically "Use the installer to automatically install and configure Talend Remote Engine.").

    During the installation procedure, provide the generated key.
14. * Available in:
    * Cloud API Services Platform
    * Cloud Data Fabric

    Redeploy all the Data Services and Routes tasks that were previously running to the new Talend Remote Engine.

## Results

The latest version of Talend Remote Engine is installed on your computer and paired with your Talend Cloud account.