Chapter 3. Analyzing your projects with the MTR plugin

You can analyze your projects with the MTR plugin by creating a run configuration, running an analysis, and then reviewing and resolving migration issues detected by the MTR plugin.

3.1. Creating a run configuration

You can create a run configuration in the Issue Explorer. A run configuration specifies the project to analyze, migration path, and additional options.

You can create multiple run configurations. Each run configuration must have a unique name.

Prerequisite

  • You must import your projects into the Eclipse IDE or CodeReady Studio.

Procedure

  1. In the Issue Explorer, click the MTR icon ( MTR button ) to create a run configuration.

  2. On the Input tab, complete the following fields:

    1. Select a migration path.
    2. Beside the Projects field, click Add and select one or more projects.

    3. Beside the Packages field, click Add and select one or more the packages.

      Note

      Specifying the packages for analysis reduces the run time. If you do not select any packages, all packages in the project are scanned.

  3. On the Options tab, you can select Generate Report to generate an HTML report. The report is displayed in the Report tab and saved as a file.

    Other options are displayed. See About MTR command-line arguments in the CLI Guide for details.

  4. On the Rules tab, you can select custom rulesets that you have imported or created for the MTR plugin.
  5. Click Run to start the analysis.

3.2. Analyzing projects

You can analyze your projects by running the MTR plugin with a saved run configuration.

Procedure

  1. In the MTR perspective, click the Run button ( Run button ) and select a run configuration.

    The MTR plugin analyzes your projects. The Issue Explorer displays migration issues that are detected with the ruleset.

  2. When you have finished analyzing your projects, stop the MTR server in the Issue Explorer to conserve memory.

3.3. Reviewing issues

You can review issues identified by the MTR plugin.

Procedure

  1. Click Window → Show View → Issue Explorer.

  2. Optional: Filter the issues by clicking the Options menu kebab , selecting Group By and an option.

    Issue Explorer "Group By" options

  3. Right-click and select Issue Details to view information about the issue, including its severity and how to address it.

    The following icons indicate the severity and state of an issue:

    Table 3.1. Issue icons

    IconDescription
    Mandatory

    The issue must be fixed for a successful migration.

    Optional

    The issue is optional to fix for migration.

    Warning

    The issue might need to be addressed during migration.

    Resolved

    The issue was resolved.

    Stale

    The issue is stale. The code marked as an issue was modified since the last time that MTR identified it as an issue.

    Mandatory with quick fix

    A quick fix is available for this issue, which is mandatory to fix for a successful migration.

    Optional with quick fix

    A quick fix is available for this issue, which is optional to fix for migration.

    Warning with quick fix

    A quick fix is available for this issue, which may potentially be an issue during migration.

  4. Double-click an issue to open the associated line of code in an editor.

3.4. Resolving issues

You can resolve issues detected by the MTR plugin by performing one of the following actions:

  • You can double-click the issue to open it in an editor and edit the source code.

    The issue displays a Stale icon ( Stale ) until the next time you run the MTR plugin.

  • You can right-click the issue and select Mark as Fixed.
  • If the issue displays a Quick Fix icon ( Mandatory with quick fix Optional with quick fix Warning with quick fix ), you can right-click the issue and select Preview Quick Fix and then Apply Quick Fix.