Red Hat SummitChapter 4. Identify and Resolve Migration Issues
Follow these steps to use the Eclipse plugin to identify and resolve migration issues.
- Import the project to analyze into Eclipse.
Create a run configuration. From the Issue Explorer, press the MTA button (
).
At a minimum, select the project to analyze. Set additional options as needed.
- Click Run to execute MTA.
- Review MTA issues listed in the Issue Explorer.
- Resolve MTA issues by manually updating code or by using quick fixes when available.
-
Run MTA again as necessary. Use the drop down next to the Run button (
) to run an existing configuration.
4.1. Create an MTA Run Configuration
MTA run configurations can be created using the MTA button (
). A run configuration specifies the project to analyze, migration path, and additional options for the execution. You can create multiple run configurations, and each must have a unique name.
Input
- Migration Path
- Select a migration path, which determines which MTA rulesets are used. The migration path defaults to Anything to EAP 7, but can be changed to any supported migration path.
- Projects
- Select one or more projects to analyze. Hold the Ctrl key to select multiple projects in the list.
- Packages
- Select one or more packages to scan. It is recommended to select only those packages that you need to analyze to reduce the overall MTA execution time. If no packages are selected, all packages in the project will be scanned. Hold the Ctrl key to select multiple packages in the list.
Options
- Report
- Check the Generate Report checkbox if you want to generate the MTA HTML report. The report will be shown in the MTA Report tab and can be found in the Issue Explorer when you group by File.
- Options
-
Set additional MTA options. Any option that is a boolean flag, such as
enableTattletale, should usetrueas the value. See the MTA Command-line Arguments section of the CLI Guide for a description of each MTA argument.
Rules
- Custom Rules Repositories
- Select custom rulesets to include during analysis if you have imported or created any custom MTA rules in the Eclipse plugin. See Add Custom Rules for more information.
4.2. Execute MTA
Once a run configuration has been created, you can execute MTA using that configuration in one of the following ways:
- Select the run configuration from the Run Configurations dialog and click Run.
-
Select a recent run configuration from the drop down next to the Run button (
).
If the MTA server is not currently running, it will start once a run configuration is executed.
If you do not plan on running MTA in the near future, it is recommended to stop the MTA server to conserve memory on your machine.
Once execution is complete, the Issue Explorer will be populated with MTA issues.
4.3. Review MTA Issues
Use the Issue Explorer to review migration issues identified by MTA. Different icons indicate the issue’s severity and state.
Change how issues are grouped by adjusting the Group By selections: Severity, Migration Rule, and File.
Double-click the MTA issue in the Issue Explorer to open the associated line of code in an editor. Right-click and select Issue Details to view information about the MTA issue, including its severity and how to address it.
4.4. Resolve MTA Issues
You can resolve MTA issues by updating the code manually or by applying a quick fix when available.
4.4.1. Resolve an Issue Manually
Review the MTA issue details and additional resources and update the source code as necessary. When you update a line of code marked as an MTA issue, the MTA issue will be marked with the stale icon (
) until the next time that MTA is run on the project.
You can also manually mark an MTA issue as fixed, which will mark the issue with the resolved icon (
) until the next time that MTA is run on the project. To mark an issue as fixed, right-click the MTA issue in the Issue Explorer and select Mark as Fixed.
4.4.2. Resolve an Issue Using a Quick Fix
Some MTA issues provide a quick fix, which assists in making the necessary edits to address the issue. See the icon legend to see the icons that indicate the MTA issue has a quick fix available.
- Preview a Quick Fix
- Right-click the issue and select Preview Quick Fix. This will bring up a window that allows you to preview the change. From here, you can apply the fix or close the window.
- Apply a Quick Fix
- Right-click the issue and select Apply Quick Fix. This will update the source code as required and will mark the MTA issue as resolved.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}