Migration Toolkit for Runtimes 

The tools, reports, and knowledge that help developers modernize applications to run in the cloud and deploy containers at scale.

The Migration Toolkit for Runtimes product will reach its End of Life by September 30th, 2024. All customers using it should start their transition to Migration Toolkit for Applications, as it is fully backwards compatible with all features and rulesets available in Migration Toolkit for Runtimes and will be maintained in the long term.


Get started with the migration toolkit for runtimes web console

The web console for the migration toolkit for runtime allows an individual or a team of users to assess and prioritize migration and modernization efforts for a large number of applications. You can install the console on a laptop or server, or 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. (Note: MTR requires that either OpenJDK 11 or Oracle JDK 11 is installed; no other JDKs are supported.)
  4. Start the web console. (Note: In Microsoft Windows ‘run_windup.bat’ can be used instead): $ ./mtr-<version>-web-console/run_windup.sh
  5. Access the migration toolkit for runtimes web console at http://localhost:8080/windup-ui.
  6. Use the migration toolkit for runtimes 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 with operator

  1. Log in with your user. Create a project for migration toolkit for runtimes (e.g., mtr).
  2. Log in with kubeadmin. In the Administrator view, go to Operators → OperatorHub
  3. Install the operator:
    1. Search for MTR. Select Migration Toolkit for Runtimes Operator. 
    2. Accept the warning.
    3. Click Install.
    4. Select the namespace to install it on, like the one we just created (mtr). Click Install.
  4. Log in with your user. Select the project previously created (mtr) and go to +Add.
  5. Instantiate migration toolkit for runtimes:
    1. Select Operator Backed.
    2. Select Migration Toolkit for Runtimes.
    3. Click Create.
    4. Review options (the default ones should be OK, but you should validate the system requirements for memory and cores). Go to the bottom of the page and click Create.
    5. Go to Topology to check the installation process.
    6. Access the web console from your browser by using the route exposed by the mtr-web-console application within OpenShift.

Documentation for the migration toolkit for runtimes

For advanced installation and configuration tips and tricks, refer to the following links to the documentation. The documentation also contains guides for other components of the migration toolkit for runtimes.

Migration toolkit for applications

If you have a Red Hat OpenShift subscription, we recommend using the migration toolkit for applications. It offers additional capabilities that focus on application portfolio management and collaborating across teams for modernization projects.

Learn more