A JBoss Project
Red Hat

Posts tagged with 'windup'

We are happy to announce the latest release of the Red Hat Application Migration Toolkit (RHAMT) Eclipse Plugin.

Getting Started

It is now available through JBoss Central, and from the update site here.

What is RHAMT?

RHAMT is an automated application migration and assessment tool.

Example ways to RHAMT up your code:

  • Moving your application from WebLogic to EAP, or WebSphere to EAP

  • Version upgrade from Hibernate 3 to Hibernate 4, or EAP 6 to EAP 7

  • Change UI technologies from Seam 2 to pure JSF 2.

An example of how to run the RHAMT CLI:

$ ./rhamt-cli --input /path/to/jee-example-app-1.0.0.ear --output /path/to/output --source weblogic --target eap:7

The output is a report used to assess and prioritize migration and modernization efforts.

The RHAMT Eclipse Plugin - What does it do?

Consider an application migration comprised of thousands of files, with a myriad of small changes, not to mention the tediousness of switching between the report and your IDE. Who wants to be the engineer assigned to that task? :) Instead, this tooling marks the source files containing issues, making it easy to organize, search, and in many cases automatically fix issues using quick fixes.

Let me give you a quick walkthrough.

Ruleset Wizard

We now have quickstart template code generators.

Rueset Wizard

Rule Creation From Code

We have also added rule generators for selected snippets of code.

Rule Generation From Source

Ruleset Graphical Editor

Ruleset navigation and editing is faster and more intuitive thanks to the new graphical editor.

Graphical Editor

Ruleset View

We have created a view dedicated to the management of rulesets. Default rulesets shipped with RHAMT can now be opened, edited, and referenced while authoring your own custom rulesets.

Ruleset View

Run Configuration

The Eclipse plugin interacts with the RHAMT CLI process, thereby making it possible to specify command line options and custom rulesets.

Run Configuration

Ruleset Submission

Lastly, contribute your custom rulesets back to the community from within the IDE.

Ruleset Submission

You can find more detailed information here.

Our goal is to make the RHAMT tooling easy to use. We look forward to your feedback and comments!

Have fun!
John Steele

We are happy to announce the first release of the Windup Eclipse Plugin. It is available now through JBoss Central, and from our update site at http://download.jboss.org/jbosstools/neon/stable/updates/windup/composite/.

What’s Windup?

Windup is a command line tool used to aid the process of migrating Java applications. Here’s a few examples:

  • You want to move your application from one application server to another, for example:

    • WebLogic to EAP

    • WebSphere to EAP

  • You want to upgrade from one version of a technology to another, for example:

    • Hibernate 3 to Hibernate 4

    • EAP 6 to EAP 7

  • You want to change technologies, for example:

    • Seam 2 UI controls to pure JSF 2 UI Controls

And here’s an example of how you’d run Windup using the CLI:

$ ./windup --input /path/to/jee-example-app-1.0.0.ear --output /path/to/output --source weblogic --target eap:7

The output of running Windup from the command line is an HTML report, which can then be used to help analyze how much effort the migration will take, as well as provide assistance with solving the individual problems.

What do the Windup Eclipse plugins do?

As previously mentioned, the output of running Windup from the command line is an HTML report, which is not very useful for the engineer responsible for making the changes in the code.

That’s where the Eclipse plugins come into play. Once you’ve run Windup from within the IDE, all the source files needing to be changed will be automatically marked, and can be easily organized, searched, and in many cases, fixed using quick fixes.

Let me give you a quick walkthrough of some of the key components. You can find more detailed information here.

Windup Perspective

We’ve created a dedicated perspective containing all the the views necessary to use Windup.

Windup Perspective

Run Configuration Dialog

Think of this as a GUI for your command line arguments. Instead of needing to dig deep into Windup documentation, and then having to tediously type paths, and other various arguments, this dialog simplifies the process of telling Windup what to analyze and how.

Run Configuration

Issue Explorer View

The Issue Explorer gets populated with all the migration issues.

Issue Explorer

You can customize how the issues are organized.

Issue Explorer Grouping

The context menu is dynamic, and will vary per issue.

Issue Explorer Context Menu

Some issues have quick fixes available. Quick fixes can be previewed prior to being applied.

Quick Fix Preview

Issue Details View

The Issue Details View provides more detailed information about migration issues, for example, hints on how to fix them, external documentation that might help with choosing the best solutions, etc.

Issue Details

Report View

You may need to refer back to the generated HTML report, and for that reason, we make it readily available here.

Windup Report


Here is a short video which demonstrates the basic usage:


We are trying our best to make the Windup tooling as good as possible. Users' feedback is what we are seeking for now. We are looking forward to hearing your comments / remarks!

Have fun!
John Steele

Looking for older posts ? See the Archived entries.
back to top