{PluginBookName}
Making open source more inclusive
Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.
1. Introduction
1.1. About the {PluginBookName}
This guide is for engineers, consultants, and others who want to use the MTR plugin for the Migration Toolkit for Runtimes (MTR) to assist with migrating applications.
1.2. About the Migration Toolkit for Runtimes
What is the Migration Toolkit for Runtimes?
The Migration Toolkit for Runtimes (MTR) is an extensible and customizable rule-based tool that simplifies the migration and modernization of Java applications.
MTR examines application artifacts, including project source directories and application archives, and then produces an HTML report highlighting areas needing changes. MTR supports many migration paths, including the following examples:
-
Upgrading to the latest release of Red Hat JBoss Enterprise Application Platform
-
Migrating from Oracle WebLogic or IBM WebSphere Application Server to Red Hat JBoss Enterprise Application Platform
-
Containerizing applications and making them cloud-ready
-
Migrating from Java Spring Boot to Quarkus
-
Updating from Oracle JDK to OpenJDK
-
Upgrading from OpenJDK 8 to OpenJDK 11
-
Upgrading from OpenJDK 11 to OpenJDK 17
-
Upgrading from OpenJDK 17 to OpenJDK 21
-
Migrating EAP Java applications to Azure
-
Migrating Spring Boot Java applications to Azure
For more information about use cases and migration paths, see the MTR for developers web page.
How does the Migration Toolkit for Runtimes simplify migration?
The Migration Toolkit for Runtimes looks for common resources and known trouble spots when migrating applications. It provides a high-level view of the technologies used by the application.
MTR generates a detailed report evaluating a migration or modernization path. This report can help you to estimate the effort required for large-scale projects and to reduce the work involved.
How do I learn more?
See the Introduction to the Migration Toolkit for Runtimes to learn more about the features, supported configurations, system requirements, and available tools in the Migration Toolkit for Runtimes.
Unresolved directive in master.adoc - include::topics/about-plugin.adoc[leveloffset=+2]
Unresolved directive in master.adoc - include::topics/installing-plugin.adoc[leveloffset=+1] :!plugin-guide:
Unresolved directive in master.adoc - include::topics/installing-plugin.adoc[leveloffset=+1] :!disconnected:
Unresolved directive in master.adoc - include::topics/plugin-access-mta-tools.adoc[leveloffset=+1]
1.3. About MTR plugin components
The following components are available in the MTR perspective when using the MTR plugin to analyze projects.
- Issue Explorer
-
This view allows you to explore the MTR issues for projects that have been analyzed.
If this view is not visible in the MTR perspective, you can open it by selecting Window → Show View → Issue Explorer.
- MTR Server
-
The MTR server is a separate process that runs the MTR analysis, flags the migration issues, and generates the reports.
You can start, stop, and view the status of the MTR server from Issue Explorer.
- Issue Details
-
This view shows detailed information about the selected MTR issue, including the hint, severity, and any additional resources.
If this view is not visible in the MTR perspective, you can open it by selecting Window → Show View → Issue Details.
- MTR Report
-
This view shows the HTML reports that are generated when MTR is executed. From the report landing page you can navigate to detailed reports, such as Application Details, Issues, and Dependencies.
Note that the MTR run configuration used must have the Generate Report option selected in order for MTR reports to be generated.
If this view is not visible in the MTR perspective, you can open it by selecting Window → Show View → MTR Report.
2. Using the MTR MTR plugin
Unresolved directive in master.adoc - include::topics/plugin-identify-resolve-issues.adoc[leveloffset=+2]
Unresolved directive in master.adoc - include::topics/plugin-review-issues.adoc[leveloffset=+3]
Unresolved directive in master.adoc - include::topics/plugin-resolve-issues.adoc[leveloffset=+3]
Unresolved directive in master.adoc - include::topics/plugin-use-custom-rules.adoc[leveloffset=+1]
Unresolved directive in master.adoc - include::topics/plugin-view-rules.adoc[leveloffset=+2]
Unresolved directive in master.adoc - include::topics/plugin-import-custom-ruleset.adoc[leveloffset=+2]
Unresolved directive in master.adoc - include::topics/plugin-create-custom-ruleset.adoc[leveloffset=+2]
Unresolved directive in master.adoc - include::topics/eclipse-submit-ruleset.adoc[leveloffset=+2]
Revised on 2025-01-08 19:10:50 CST