Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

Chapter 3. Tools to Assist in Migration

3.1. Use Red Hat Application Migration Toolkit to Analyze Applications for Migration

Red Hat Application Migration Toolkit (RHAMT) is an extensible and customizable rule-based set of tools that helps simplify migration of Java applications. It analyzes the APIs, technologies, and architectures used by the applications you plan to migrate and provides detailed migration reports for each application. These reports provide the following information.

  • Detailed explanations of the migration changes needed
  • Whether the reported change is mandatory or optional
  • Whether the reported change is complex or trivial
  • Links to the code requiring the migration change
  • Hints and links to information about how to make the required changes
  • An estimate of the level of effort for each migration issue found and the total estimated effort to migrate the application

You can use RHAMT to analyze the code and architecture of your JBoss EAP 6 applications before you migrate them to JBoss EAP 7. The RHAMT rule set for migration from JBoss EAP 6 to JBoss EAP 7 reports on XML descriptors and specific application code and parameters that need to be replaced by an alternative configuration when migrating to JBoss EAP 7.

For more information about how to use Red Hat Application Migration Toolkit to analyze your JBoss EAP 6 applications, see the Red Hat Application Migration Toolkit Getting Started Guide.

3.2. Use the JBoss Server Migration Tool to Migrate Server Configurations

The JBoss Server Migration Tool is the preferred method to update your server configuration to include the new features and settings in JBoss EAP 7 while keeping your existing configuration. The JBoss Server Migration Tool reads your existing JBoss EAP server configuration files and adds configurations for any new subsystems, updates the existing subsystem configurations with new features, and removes any obsolete subsystem configurations.

You can use the JBoss Server Migration Tool to migrate standalone servers and managed domains for the following configurations.

From JBoss EAP 6.4 or JBoss EAP 7.0 to JBoss EAP 7.1

The JBoss Server Migration Tool ships with JBoss EAP 7.1, so there is no separate download or installation required. You run the tool by executing the jboss-server-migration script located in the EAP_HOME/bin directory. For more information about how to configure and run the tool, see Using the JBoss Server Migration Tool.

It is recommended that you use this version of the JBoss Server Migration Tool to migrate your server configuration to JBoss EAP 7.1 as this version of the tool is supported.

From JBoss EAP 6.4 to JBoss EAP 7.0

For migration to JBoss EAP 7.0, you must download the latest binary distribution of the JBoss Server Migration Tool from the Server Migration Tool GitHub. For information about how to run the tool, see the JBoss Server Migration Tool User Guide.

Important

This version of the JBoss Server Migration Tool is not supported. Rather than use this version to migrate your server configuration to JBoss EAP 7.0, it is recommended that you use the supported version of the tool to migrate your server configuration directly to JBoss EAP 7.1 instead.