FUSE Eclipse Tools

FUSE provides a set of Eclipse tools to support development with the FUSE ESB and FUSE Services Framework distributions. Before installing the tools from the FUSE Update Site, it's important that you first go to the Eclipse Europa Update Site to download all of the pieces that you need to get started with FUSE ESB and FUSE Services Framework development.

These instructions assume that you are using Eclipse 3.3 (download)

Eclipse Dependencies

The FUSE Tools use and extend the facilities of the Eclipse Web Tools Platform . This in turn is built upon and extends a number of other Eclipse projects. The best way to get started is to download these and install them into your Eclipse installation separately. We do have a version-specific dependency on the Web Tools Platform code, so it's important that you take the version that is linked below.

You will need

• Eclipse Classic 3.3.2
  This contains the Jave IDE, Eclipse Platform and all the user and developer documentation. This is hefty download, weighing in around 120MB.

• Web Tools Platform 2.0.2
  This project contains all the code and capabilities to allow the development of Web services, JEE applications and Web applications. The FUSE Tools use infrastructural elements provided by the Web Tools Platform, for example the wizard and runtime server frameworks. The download is roughly 39MB.

• Eclipse Modeling Framework 2.3.2 (4.2MB) and the XSD Modeling (1.1MB) are both required for Web Tools.

• Graphical Editing Framework 3.3.2 (1.1MB) is also used by Web Tools.

• Data Tools Platform 1.5.2 (9MB) is the final prerequisite.

Each link above should direct to you a mirror site choice page for the appropriate download. Once you have downloaded all of the zip files, unzip them all to the same folder. The result should be the appearance of a folder called eclipse. You now have a fully loaded Eclipse installation, ready to add the FUSE Tools. If anything doesn't seem to work, let us know in the FUSE Tooling forum.

Updating Eclipse from the FUSE Update Site

Start your Eclipse from the eclipse folder you created when you unzip all the parts. This will be your FUSE IDE, once you've installed all of the FUSE Tools plugins from the open.iona.com update site. This section will show you how to do the install.

• Select the Help > Software Updates > Find and Install... menu item.
• Check the Search for new features to install and press Next >
• Press the New Remote Site... button to add the FUSE update site to your list of sites. Fill out the form as in the picture below - the update site URL is http://repo.open.iona.com/consolidated-fuse-update-site/.

• Press OK
• Press Finish and the Update Manager will download the site content details.

The first choice on this page IONA FUSE Tooling 1.4.2 contains all of the tools and the help screens and documentations. It's about 25MB.

• Check the download you want and then press Next > - the update manager will present a license to you.

• Check I accept... and press Next > - the update manager will give you a summary of what it is about to do

• Press Finish and the update manager will download the FUSE tools and update your Eclipse installation. It will ask you to confirm installing the software

• Press Install or Install All to confirm that the software is to be installed.

• Press Yes to restart your Eclipse installation and you should be ready to go.

How do I know it has worked?

When Eclipse restarts, the first thing you should see is a welcome page. This will FUSE links on it, with an graduated orange background.

Choose the File > New > Project... menu item. In the wizard selection wizard that appears, you will see a number of wizards that you can choose to create JBI- and FUSE-based projects in your Eclipse IDE.

The Eclipse FUSE tools use Maven, just like the command-line ones. As the FUSE projects get created, you will see Maven output in the Eclipse Console view. Any errors that can occur during Maven's resolution of the necessary packages will appear in that view. Let us know in the FUSE Tooling forum if you see anything unexpected.

Known issues

ESB-14 An internal error occurred during: "J2EEComponentMappingUpdateJob" dialog when creating JBI Service Units.

This means there is an incompatibility in the version of the Web Tools Platform that your Eclipse installation is using.
There is a patched plugin at the FUSE tools update site that resolves this issue - download the patched plugin here and drop it into your eclipse/plugins folder. Let us know at the FUSE Tooling forum if this does not work for you.

Older Screencasts on Using the Fuse Tooling

WARNING! Although the following screencasts are a bit out of date, they are still fairly applicable today. If you have any questions, please ask them in the FUSE Tooling forum.

Click on the following links to view Flash screencasts for each topic noted:

• Running a Fuse ESB Server instance within Eclipse

• Creating a contract first service using Eclipse

Generating Java From WSDL Correctly in the Contract First Tutorial In the contract first tutorial above, in order to correctly generate Java from WSDL, you edit the pom.xml file and change the configuration of the xfire-maven-plugin's outputDirectory element to point to the correct directory. Below is the correct element: <outputDirectory>target/generated-sources</outputDirectory>

• Creating a JBI Service Engine using Eclipse

If you have any questions, please ask them in the FUSE Tooling forum.