How to download and apply a patch for version 6.x and above

author
Talend Documentation Team
EnrichVersion
6.5
EnrichProdName
Talend Data Fabric
Talend Big Data Platform
Talend Real-Time Big Data Platform
Talend Big Data
Talend MDM Platform
Talend Data Integration
Talend Data Services Platform
Talend Data Management Platform
Talend ESB
task
Installation and Upgrade
EnrichPlatform
Talend Studio
Talend CommandLine

Downloading a patch

A patch is a software update that fixes bugs.

You are granted access to the patch by Talend Support and you can download it either via Talend Administration Center or manually.

Download a patch via Talend Administration Center

Before you begin

  • You have asked Talend Support to assign a patch to your customer account.
  • You have installed and started Talend Administration Center and your local Nexus server.

  • You have your client credentials provided in the license email sent by Talend.

For more information about Talend Administration Center, see the Talend Administration Center documentation.

Procedure

  1. In Talend Administration Center, in the Menu panel, click Configuration and then Software Update to configure the following parameters.
    Field Value
    Talend update url https://talend-update.talend.com/nexus

    Talend update username

    The username provided in your license email sent by Talend

    Talend update password

    The password provided in your license email sent by Talend

    Local repository url

    http://{your local nexus ip}:8081/nexus

    Local deployment username

    talend-updates-admin
    Local deployment password talend-updates-admin
    Local reader username talend-updates-admin

    Local reader password

    talend-updates-admin

    Local repository ID

    talend-updates
  2. Open the Software Update page and click the icon next to the patch you want to download.
    In this example, you want to download the last patch.

Results

The patch is removed from the list and saved on the local Nexus server.

Download a patch manually

Before you begin

  • You have asked Talend Support to assign a patch to your customer account.
  • You have your client credentials provided in the license email sent by Talend.

Procedure

  1. In Talend Remote Nexus server, sign in with your client credentials.
  2. Go to the exact URL provided by Talend Support to download the patch and save it on your computer.

Applying a patch

After downloading the patch, you can apply it. The processes for applying the patch are different for Talend Studio/CommandLine patches and other types of patch (such as ESB patches).

Apply a patch to Talend Studio/CommandLine

You can apply a patch to Talend Studio/CommandLine:
  • via Talend Administration Center and Nexus
  • manually, by creating a specific folder for patches (only from version 6.2.1 and above).

Apply a patch via Talend Administration Center and Nexus

Before applying the patch

Before you apply the patch, bear the following in mind.

  • If you download a patch to the local Nexus server, any Studio which connects to Talend Administration Center will be updated automatically even if you want to test the patch on only one Studio.
  • A backup is not automatically created for the Studio before the automated patch is applied.
  • As an administrator, if you want to test the patch you need to have a test environment where you download the patch and test it. If all goes well, you proceed to download the tested patch in the production environment.

Applying a patch to Talend Studio

  • You have downloaded your patch to the local Nexus server.
  1. Open and restart Talend Studio in Remote mode.

    Talend Studio asks Talend Administration Center if there is any patch that has been downloaded to the local Nexus server and not yet applied to the Studio.

  2. Click the Update button.

    Talend Studio applies the patch and restarts automatically.

Applying a patch to CommandLine

  • You have downloaded your patch to the local Nexus server.
  1. Use the following startup script to start CommandLine in interactive mode:

    Talend-Studio-win-x86_64.exe -nosplash -application org.talend.commandline.CommandLine -consoleLog -data commandline-workspace startServer -p 8002 --talendDebug

  2. Run the following two commands to apply the patch:
    • initRemote {tac_url} -ul {TAC login username} –up {TAC login password}

      For example: initRemote http://localhost:8080/org.talend.administrator/ -ul admin@company.com –up admin

    • checkAndUpdate -tu {TAC login username} -tup {TAC login password}

      For example: checkAndUpdate -tu admin@company.com -tup admin

  3. Stop and restart your CommandLine as usual.
Note: If you encounter any problems when downloading or applying a patch, open a support ticket.

Apply a patch manually to Talend Studio/CommandLine

Since version 6.2.1, an option allows you to apply a patch manually to one Studio by creating a specific folder for patches in Talend Studio/CommandLine.

Procedure

  1. Create a folder named patches in Talend Studio or CommandLine.
  2. Copy the previously downloaded zip file containing the patch in this folder.
  3. Start the patched Talend Studio/CommandLine.
    When Talend Studio (or CommandLine) starts, it checks if there is a new patch in this folder, then installs it.
  4. Click OK in the confirmation message which is displayed.

Apply a patch manually to other modules

This process applies when you want to apply a patch to modules other than Talend Studio/CommandLine.

Before you begin

  • You have downloaded the patch to your computer.

Procedure

  1. Unzip the downloaded file.
  2. Follow the steps in the README file to apply the patch manually.