How to download and apply a patch - 7.0

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

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/Talend CommandLine patches and other types of patch (such as ESB patches).

Apply a patch to Talend Studio/Talend CommandLine

You can apply a patch to Talend Studio/Talend CommandLine:
  • via Talend Administration Center and Nexus
  • manually, by creating a specific folder for patches

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 Talend CommandLine

  • You have downloaded your patch to the local Nexus server.
  1. Use the following startup script to start Talend 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 Talend 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/Talend CommandLine

You can apply a patch manually to your Talend Studio by creating a specific folder for patches in Talend Studio/Talend CommandLine.

Procedure

  1. Create a folder named patches in Talend Studio or Talend CommandLine.
  2. Copy the previously downloaded zip file containing the patch in this folder.
  3. Start the patched Talend Studio/Talend CommandLine.
    When Talend Studio (or Talend 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/Talend 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.