How to improve the migration check report - 7.0

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
Talend Administration Center
Talend CommandLine
Installation and Upgrade

How to improve the migration check report

When running a migration check, you will need to be able to compare Job compilation status in various versions of your Talend product.

This article helps improve the Migration Check report by adding a patch to your previous Talend CommandLine in order to get Job compilation status information.

(Optional) Setting the migration report folder path

By default, migration reports are stored in the /Talend/MigrationCheck/reports folder on Linux and the C:/Talend/MigrationCheck/reports folder on Windows. If you want to edit the default path to the folder where your reports will be stored, you need to do so in the file.


  1. Open the following file: <TomcatPath>/webapps/org.talend.administrator/WEB-INF/classes/
  2. Add the following parameter and value, then save your changes:

    where <FolderPath> corresponds to the path to the folder where you want to store your migration reports.

Installing a migration check patch to compare Job compilation status

When generating a detailed migration report containing information about Job compilation status, you may want to compare this report to other previous versions of Talend. To do so, you need to install migration check patches in your Talend CommandLine installation folder.


  1. Go to the following URL addresses, enter the credentials you received with your license email, then click the link again to get your patch:

    5.4.1 migration patch

    5.4.2 migration patch

    5.5.1 migration patch

    5.5.2 migration patch

    5.6.1 migration patch

    5.6.2 migration patch

  2. Install the patch corresponding to your previous version, for example, in the following folder: TalendCommandLinePath>/plugins
  3. Open the following file to edit it: <TalendCommandLinePath>/configuration/config.ini
  4. Add

    to the end of the osgi.bundles parameter value.

  5. Remove the following file:


Executing the migration commands

How to generate a migration report by executing specific commands either from the Talend CommandLine or the Talend Administration Center application.


  1. From Talend CommandLine:
    • Execute the following commands to generate report from a 5.6.x version:

      logonProject -pn <ProjectAName> -ul <UserName>
      migrationCheck -dp <ProjectDatabasePath>
      logonProject -pn <ProjectBName> -ul <UserName>
      migrationCheck -dp <ProjectDatabasePath>
    • Execute the following commands to generate report from a 6.0.x+ version:

      Import the same projects and execute migrationCheck actions one by one as for 5.6.x versions, then execute:

      generateMigrationReport -dp <ProjectDatabasePath> -from 5.6.1 -to 6.0.0 -ps <ProjectAName>|<ProjectBName> 
      -rp <ReportFolderPath>/

      The archive file is generated in the folder specified.

  2. From Talend Administration Center:
    1. From the Migration Check page, configure the connections to both source (old) and target (new) CommandLine applications.
    2. Enter the paths to the local directories where the database and report will be stored and start the migration.


The .pdf reports are generated in the Report List area of the application page as well as in the local folder you have previously defined.