Chapter 1. Introduction


1.1. About the Rules Development Guide

This guide is for engineers, consultants, and others who want to create custom XML-based rules for Migration Toolkit for Runtimes (MTR) tools.

For more information, see the Introduction to the Migration Toolkit for Runtimes for an overview and the CLI Guide for details.

1.1.1. Use of <MTR_HOME> in this guide

This guide uses the <MTR_HOME> replaceable variable to denote the path to your MTR installation. The installation directory is the mtr-1.0.2.GA-offline directory where you extracted the MTR .zip file.

Note

If you are installing on a Windows operating system:

  1. Extract the .zip file to a folder named mtr to avoid a Path too long error. Alternatively, extract the file with 7-Zip to a folder of any name you choose.
  2. If a Confirm file replace window is displayed during extraction, click Yes to all.

When you encounter <MTR_HOME> in this guide, replace it with the actual path to your MTR installation.

1.2. About MTR rules

The Migration Toolkit for Runtimes (MTR) contains rule-based migration tools that analyze the APIs, technologies, and architectures used by the applications you plan to migrate. In fact, the MTR analysis process is implemented using MTR rules. MTR uses rules internally to extract files from archives, decompile files, scan and classify file types, analyze XML and other file content, analyze the application code, and build the reports.

MTR builds a data model based on the rule execution results and stores component data and relationships in a graph database, which can then be queried and updated as needed by the migration rules and for reporting purposes.

MTR rules use the following rule pattern:

when(condition)
  perform(action)
otherwise(action)

MTR provides a comprehensive set of standard migration rules out-of-the-box. Because applications may contain custom libraries or components, MTR allows you to write your own rules to identify use of components or software that may not be covered by the existing ruleset.

If you plan to write your own custom rules, see the Rules Development Guide for detailed instructions.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.