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.

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. (Note: In Microsoft Windows ‘run_mta.bat’ can be used instead): $ ./mta-web-distribution-<version>/run_mta.sh
  5. Access the MTA web console at http://localhost:8080/mta-ui
  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 4.5+ with operator

  1. Log in with your user. Create a project for MTA like, for example, "mta"
  2. Log in with “kubeadmin”. In the “Administrator” view go to “Operators” → “OperatorHub” 
  3. Installing the operator
    • Search for MTA. Select “Migration Toolkit for Applications Operator” 
    • Accept the Warning
    • Click on “Install”
    • Select the namespace to install it on, like the one we just created “mta”. Click “Install”
  4. Log in with your user. Select the project previously created (i.e. “mta”) and go to “+Add”
  5. Instantiate MTA
    • Select “Operator Backed” 
    • Select “Migration Toolkit for Applications”
    • Click “Create”
    • Review options (default ones should be OK, but better validate the system requirements for memory and cores). Go to the bottom of the page and click “Create”
  6. Go to “Topology” to check the installation process
  7. Access the web console from your browser by using the route exposed by the mta-web-console application within OpenShift

Option 3 - Install on OpenShift with template

  1. Download the ZIP archive.
  2. Extract the ZIP archive.
  3. Install MTA template by importing this template into your OpenShift environment: /mta-web-distribution-<version>/openshift/templates/web-template-empty-dir-executor.json
  4. Instantiate the template (validate the system requirements for memory and cores).
  5. Access the web console from your browser by using the route exposed by the mta-web-console application within OpenShift.
  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.

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

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

Other

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.