How to improve the migration check report

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

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 configuration.properties file.

Procedure

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

    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.

Procedure

  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, migrationcheck_5.4.1r111943_patch.zip for example, in the following folder: TalendCommandLinePath>/plugins
  3. Open the following file to edit it: <TalendCommandLinePath>/configuration/config.ini
  4. Add
    ,reference\:file\:org.talend.commandline.migrationcheck_5.6.2.201503181110@4

    to the end of the osgi.bundles parameter value.

  5. Remove the following file:

    <TalendCommandLinePath>/configuration/org.eclipse.osgi

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.

Procedure

  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>
      logoffProject
      logonProject -pn <ProjectBName> -ul <UserName>
      migrationCheck -dp <ProjectDatabasePath>
      logoffProject
    • 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>/report.zip

      The report.zip 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.

Results

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.