Chapter 3. Tools to Assist in Migration

3.1. Use Windup to Analyze Applications for Migration

Windup, which is part of the Red Hat JBoss Migration Toolkit, is an extensible and customizable rule-based tool 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 effort to migrate the application

You can use Windup to analyze the code and architecture of your JBoss EAP 6 applications before you migrate them to JBoss EAP 7. The Windup 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 Windup to analyze your JBoss EAP 6 applications, see the Windup User Guide.

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

The JBoss Server Migration Tool, which is currently under development, will be the preferred method to update your 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 6 server configuration file and adds configurations for the new subsystems, updates existing subsystem configurations with new features, and removes obsolete subsystem configurations.

The latest pre-release binary distribution of the JBoss Server Migration Tool is available for download from This version supports the migration of standalone servers and managed domains from JBoss EAP 6.4 to JBoss EAP 7.0. For general information about to run the tool, see the JBoss Server Migration Tool User Guide.


The pre-release version of the JBoss Server Migration Tool is not yet supported.