Chapter 4. Testing XML Rules


4.1. Add the Rule to Migration Toolkit for Applications

A Migration Toolkit for Applications rule is installed by copying the rule to the appropriate MTA folder. MTA scans for rules, which are files that end with .windup.xml or .rhamt.xml, in the following locations.

  • The directory specified by the --userRulesDirectory argument on the MTA command line.
  • The RHAMT_HOME/rules/ directory. RHAMT_HOME is the directory where you install and run the Migration Toolkit for Applications executable.
  • The ${user.home}/.rhamt/rules/ directory. This directory is created by MTA the first time it is executed and contains rules, add-ons, and the MTA log.

    Note

    For Windows, this directory would be \Documents and Settings\USER_NAME\.rhamt\rules\ or \Users\USER_NAME\.rhamt\rules\.

4.2. Test the XML Rule

Test the XML rule against your application file by running MTA in a terminal.

Copy to Clipboard Toggle word wrap
$ RHAMT_HOME/bin/rhamt-cli [--sourceMode] --input INPUT_ARCHIVE_OR_FOLDER --output OUTPUT_REPORT_DIRECTORY --target TARGET_TECHNOLOGY --packages PACKAGE_1 PACKAGE_2 PACKAGE_N

You should see the following result:

Copy to Clipboard Toggle word wrap
Report created: OUTPUT_REPORT_DIRECTORY/index.html
              Access it at this URL: file:///OUTPUT_REPORT_DIRECTORY/index.html

More examples of how to run MTA are located in the Migration Toolkit for Applications CLI Guide.

Back to top
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. Explore our recent updates.

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.

Theme

© 2025 Red Hat, Inc.