Application Migration Toolkit

Hello World!

Build Something Today

Let's walk through everything you need to build your first application.

Hello World!

1. Set up your environment

  1. Install the Java SE Development Kit (JDK) version 8. We recommend using the OpenJDK or the Oracle JDK.

  2. Install the RHAMT CLI.

    1. Download the ZIP archive.

    2. Extract the ZIP archive.

      $ unzip 

2. Analyze your first application


Now that the RHAMT CLI is installed, you’re ready to try it out. We’ll show you how to run the CLI to analyze a sample WebLogic application to identify the changes necessary to migrate it to JBoss EAP 7.

  1. Download the sample application, simple-sample-app.ear, to your file system.

  2. Run the CLI with the necessary options.

    1. Navigate into the rhamt-cli-4.3.1.Final/bin/ directory.

    2. Execute the CLI with the necessary options.

      $ ./rhamt-cli --input /path/to/simple-sample-app.ear --output /path/to/output/ --source weblogic --target eap:7 --packages com.acme

      This command uses the following options:

      • --input: Path to the application to analyze.

      • --output: Output directory for the generated reports.

      • --source: Source technology of the application.

      • --target: Target technology for the application migration.

      • --packages: List of packages to evaluate.

  3. Open the generated report.

    1. The location of the report is displayed in your terminal once the execution is complete.

      Report created: /path/to/output/index.html  
                          Access it at this URL: file:///path/to/output/index.html
    2. Open index.html in a browser.

  4. Review the reports.

    1. In the Application List, take note of the story points identified for the simple-sample-app.ear application. This helps you assess the level of effort required to migrate this application.

    2. Click the simple-sample-app.ear link.

    3. Click the Migration Issues link in the top navigation bar. This report shows a summary of all migration issues identified in the application.

    4. Click on an issue to show the list of files that contain the issue.

    5. Click the file name to view the file contents.

    6. The line of code affected by the issue is highlighted and information about the issue and how to resolve it are displayed.

    7. See the Review the Reports section of the RHAMT CLI Guide to learn more about examining other available reports.

3. Next steps


Now that you’ve learned how to use the CLI to analyze a sample application, get started using the CLI to analyze your applications for your migration or modernization effort!

  • Learn more about using the RHAMT CLI.

    • See the CLI Guide for more information on the CLI, such as customizing the options for your analysis, overriding RHAMT rules, and optimizing performance.

    • Watch the CLI demo video for an overview of running the RHAMT CLI and reviewing the reports.

  • Check out the RHAMT IDE plugin for assistance with updating your source code for migration issues identified by RHAMT.

  • Review existing application migration articles on the Red Hat Customer Portal.

Additional Content

Want to know more about what you can do with Red Hat Application Migration Toolkit?

  • See the Getting Started Guide for information on features, supported configurations, and other tools in the toolkit.

  • See the Rules Development Guide for how to create your own custom rules to identify issues specific to your applications.

Build Something Today

Let's walk through everything you need to build your first application.