Interested about the Future of Enterprise Integration with the UltraESB ?
 

Tuesday, 29th May from 09:00 - 10:00 AM PDT, Presented by Asankha Perera, Founder and CTO of AdroitLogic

Register for the Webinar

Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

This guide describes the steps to be taken to setup the Eclipse IDE to configure, run/test and debug UltraESB mediation solutions. We have used the Eclipse 3.5.2 for this exercise.

To get started with, start the Eclipse IDE and open an existing workspace or select a new workspace (e.g. /home/asankha/eclipsewkspace). If you are already on the Eclipse Workbench, select File->Switch workspace and select the workspace or select 'Other' to specify a new workspace.

Select File->Import and from the popup window options select, General->Existing Projects into Workspace and specify the path to the UltraESB installation (e.g. /home/asankha/java/ultraesb-1.6.0)

You may now see 2 errors reported within the project, stating that the required library tools.jar is missing. This is due to a known issue, as the path to the tools.jar of the JDK is hard coded; as Eclipse cannot automatically locate the tolls.jar from the JDK in use [MECLIPSE-253].

Right click the error line "Project 'UltraRuntime' is missing required library..." and select 'Quick Fix' from the popup menu. Press the 'Finish' button to correct the fix for 'Configure build path'. Then from the 'Libraries' tab, select 'tools.jar' and specify the correct path (e.g. /opt/jdk/lib/tools.jar) according to your JDK.

To create a Run configuration to run or debug the UltraESB from within the Eclipse IDE, go to Run -> Run Configurations. Create a new 'Java Application' configuration selecting the project as 'UltraRuntime' and the main class as 'org.adroitlogic.ultraesb.UltraServer'. Specify '--confDir=conf' as program arguments, and '-Djava.endorsed.dirs=lib/endorsed' as VM arguments. This creates an Eclipse run configuration to start/debug the default UltraESB configuration as defined in the conf/ultra-root.xml and conf/ultra-dynamic.xml.

If you want to create a run configuration for a sample, specify the program arguments as '--confDir=conf --rootConf=samples/conf/ultra-sample-101.xml' etc, selecting the sample configuration you want to configure.

Note

To setup XML file editing with schema based auto-completion etc, refer to standard Eclipse documentation and extensions. For information on setting up Eclipse for use with Groovy or other JSR 223 scripting languages, refer to this forum post.

Congratulations!! You and your IDE is now ready to start the development, running, testing and debugging of your UltraESB integration solution!

Labels
  • None