Windup 2.5 demo video

[Browser with windup.jboss.org]
Hi everyone!

I'm Ondřej Žižka and this is Windup two dot five.

Windup is a tool that helps you with migration of a project from one platform to another.
It is rule-based, extendable, pluggable, modular. I will show you all that later.
But now, let's have a look at Windup in action!

[Folder Window]
Here is the application you are going to migrate.
Normally, you would go to the sources click around randomly to get an idea of how the application looks like.
But what if the application is huge? You have no chance to go trough not even 1 percent of the application.
And what if you don't have an access to the sources at all?

With Windup, you don't need the sources, and Windup analyzes the whole application and gives you overall summary like this one.
[Browser - Report]

Let's see how to do it.

[Browser with windup.jboss.org]
First, you download the latest Windup at windup.jboss.org .

[HIDDEN console]

1. 1. 1. Hidden:
         rm ~/Desktop/WindupDemo/jboss-migrationtoolkit-windup-*.GA.zip
         cp ~/work/Migration/windup-distribution/target/windup-distribution-*-offline.zip ~/Desktop/WindupDemo/
         mv ~/Desktop/WindupDemo/windup-distribution-*-offline.zip ~/Desktop/WindupDemo/jboss-migrationtoolkit-windup-2.4.0.GA.zip

When it's done, unzip Windup and go to the unzipped directory.

1. 1. 1. Visible:
         cd ~/Desktop/WindupDemo/
         unzip windup-distribution-2.5.*-offline.zip
         rm windup-distribution-2.5.*-offline.zip

It contains a script bin/windup. From now on, we will work in a console.
[Console]

Let's run Windup.
[Console]
wind<TAB>/bin/windup
...

This shows us what options Windup accepts. It needs at least the input application.
[Console]
wind<TAB>/bin/windup --input jee<TAB> --output reports --offline --packages com.acme

This is quite a small application, so it's done pretty quickly.
Let's have a look at the report.

[Browser - Report]

The first page lists the applications we have analyzed. We had only one so it only contains that one.
Clicking on it reveals the Application report.

• On the main page, you can see the overall statistics which give you the idea of how much effort is the migration going to take.
• The Migration Issues Report lists the issues by type. You can check in which files was the particular issue found.
• In the Application report, you can see the details of individual application modules.

If you are interested about particular migration points of interest, you can go to the level of individual source files.

Windup also creates special reports for some technologies, like EJB report with an overview of EJB beans, or a JPA report with Entities.

Some of the files like XML descriptors are migrated by Windup automatically.
And this is Windup in two minutes!

------------------

In the beginning of this video, I promised to show you how this all works.
Windup is rule-based, which means that the issues you could see in the report are found by rules.
Most of the rules are written in simple XML files like this one.
Custom rules can be created and used without any compilation - simply put them in a directory and tell Windup to use them.

Windup is currently focused on migrating enterprise Java applications, so most of our queries and actions cover Java source analysis or XML configuration. However, it's relatively easy to write your own extension for any language or platform.

If you have a suggestion which area Windup should cover, we are always happy to respond.
Check the windup.jboss.org site for ways to contact us.
[Browser - Windup -> Code]

If you are interested in Windup development, check the project page at Github.com/windup.

Thanks for watching and now go try Windup