Migration Toolkit for Applications

The tools, reports, and knowledge that help developers accelerate application modernization and migration projects.

Get started with Migration Toolkit for Applications web console

The web console for the Migration Toolkit for Applications (MTA) allows an individual, or a team of users to assess and prioritize migration and modernization efforts for a large number of applications. The console can be installed on a laptop or server, or installed on OpenShift. Here are instructions on how to get started for both scenarios.

Option 1 - Install locally

1. Download the ZIP archive.

2. Extract the ZIP archive.

3. Check if your machine meets the prerequisites.

4. Start the web console.
$ ./mta-web-distribution-5..1.Final/run_mta.sh
Note: In Microsoft Windows ‘run_mta.bat’ can be used instead

5. Access the MTA web console at http://localhost:8080/mta-web

6. Use the MTA web console to analyze the sample application (jee-example-app-1.0.0.ear) included in the ZIP file’s samples folder.

Option 2 - Install on OpenShift

1. Download the ZIP archive.

2. Extract the ZIP archive.

3. Install MTA by importing the the template below into your OpenShift environment

4. Access the web console from your browser by using the route exposed by the mta-web-console application within OpenShift.

5. Use the MTA web console to analyze the sample application (jee-example-app-1.0.0.ear) included in the ZIP file’s samples folder.

Documentation for Migration Toolkit for Applications

For advanced installation and configuration tips and tricks, we've added links to the documentation. The documentation also contains "Getting started" guides for MTA's other components.

Introduction to MTA
Release Notes and Known Issues

MTA Tools and Guides
Web Console Guide
CLI Guide
IDE Plugin Guide
Maven Plugin Guide
Rules Development Guide

Documentation for older versions 


Collaborate and contribute

The Migration Toolkit for Applications contains a broad variety of transformation rule bundles with thousands of rules and code hints to support numerous use cases and migration paths. The rule sets are extensible and users are encouraged to develop their own custom rules to cater for scenarios not covered by the product. Please share your custom rules with the community so they can be included into future releases of MTA.

Resources and how to get in touch with the team behind MTA

The Rules Development Guide provides comprehensive instructions for developing and testing new rules.

To share a rule with the MTA community follow these steps.

  • Create a Jira within the WINDUPRULE project describing the purpose of your rule/ruleset. 

  • Submit a Pull Request to the windup/windup-rulesets Github repository containing your rules, test data and tests.

  • Update the Jira and add a link to the URL of the Pull Request.

Follow the Migration Toolkit team on TwitterGet involved and don't miss the latest news and discussion about the Migration Toolkit for Applications.

Need any help with your Modernization or Migration endeavor?

Especially large application transformation projects can be challenging at first. Maybe you are unsure about the best methodology, the use of the tools to help with effort estimation, or you need to create a business case, or maybe you are looking to scale out into a factory model. At Red Hat we have been doing these types of projects for years. Do not hesitate to reach out to us and discuss best practices or get any questions you may have answered by a Red Hat expert.