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

Subscription

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

Open the following file: <TomcatPath>/webapps/org.talend.administrator/WEB-INF/classes/configuration.properties.
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

Subscription

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

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
Install the patch corresponding to your previous version, migrationcheck_5.4.1r111943_patch.zip for example, in the following folder: TalendCommandLinePath>/plugins
Open the following file to edit it: <TalendCommandLinePath>/configuration/config.ini

Add

,reference\:file\:org.talend.commandline.migrationcheck_5.6.2.201503181110@4

to the end of the osgi.bundles parameter value.

Remove the following file:
<TalendCommandLinePath>/configuration/org.eclipse.osgi

Executing the migration commands

Subscription

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

Procedure

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.
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.