Red Hat Training

A Red Hat training course is available for Red Hat Application Migration Toolkit

Chapter 4. Testing XML Rules

4.1. Add the Rule to Red Hat Application Migration Toolkit

A Red Hat Application Migration Toolkit rule is installed by copying the rule to the appropriate RHAMT folder. RHAMT 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 RHAMT command line.
  • The RHAMT_HOME/rules/ directory. RHAMT_HOME is the directory where you install and run the Red Hat Application Migration Toolkit executable.

  • The ${user.home}/.rhamt/rules/ directory. This directory is created by RHAMT the first time it is executed and contains rules, add-ons, and the RHAMT 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 RHAMT in a terminal. 

$ 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: 

Report created: OUTPUT_REPORT_DIRECTORY/index.html
              Access it at this URL: file:///OUTPUT_REPORT_DIRECTORY/index.html

More examples of how to run RHAMT are located in the Red Hat Application Migration Toolkit CLI Guide.