Introduction

This document will guide you through importing ServiceMix into the IDE Eclipse.

Pre-Installation Requirements

Hardware:

• 52 MB of free disk space for the ServiceMix 3.x binary distribution.
• 18 MB of free disk space for the ServiceMix 3.x source or developer's distributions.

Operating Systems:

• Windows: Windows XP SP2, Windows 2000.
• Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX, HP-UX, Solaris, any Unix platform that supports Java.

Environment:

• Java Developer Kit (JDK) 1.5.x (Java 5) for compiling/building.
• The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g., c:\Program Files\jsdk.1.5.x
• Maven 1.0.2 or greater.
• Eclipse 3.x or greater.

Importing ServiceMix

Below are the steps to import ServiceMix as a project in Eclipse.

Preparing the Files for Eclipse

1. Grab the sources from svn or download servicemix source distribution.
   
2. From the command line execute the following Maven 2 command to ready the project for Eclipse.

   Code Block
   mvn eclipse:eclipse

In Eclipse:

1. From the "File" menu select "Import". 
   
   Image Added
   
   
2.  Select "Existing Projects into Workspace" and click "Next" 
   
   Image Added
3. Download servicemix source distribution.
   
4. Put in the Eclipse tags:
   maven -Dmaven.test.skip=true default eclipse
   
5. In Eclipse:
   File>Import
   
   
6. Browse for the root directory, which is the directory in which you downloaded ServiceMix.
     "Select all All" the files in the Import pop-up window. They are probably already pre-selected for you (check box is checked).  Click "Finish" in the Import window. 
   
   Image Added
   
   
7. From the "Windows" menu and click "Preferences"Windows>Preferences
   The Preferences window will pop-up.
   Change to JDK 5
   Windows>preferences click on Compiler
   Compiler compliance level must be 5.0, pull down menu and select.
   Check the "Use default compliance settings" box. 
   
   Image Added
   
   
8. Then check under "Installed JREs" that you have JDK 5, e.g., jre_1.5.x x 
   Click Ok
   Image Added
   
   
9. Click on the Java plus sign, then click on Build Path
   then select Classpath Variables. 
   
   Image Added
   
   
10. Click on New button to right
    A pop-up appears.
    Enter the Name: MAVENM2_REPO
    Enter the Path, which is your local maven repository, usually located in
    your home directory .mavenm2, for example:
    C:\Documents and Settings\Lisa Malgerignodet\.maven\repository m2\repository 
    
    Image Added
    
    

Running an Example

1. Now you can run an example:
   a. In the Package Explorer find the Main class, which should be located in: servicemix-core/src/main/java/
   under org.apache.servicemix/Main.java.
   Double click on the main() class. 
   
   Image Added
   
   
2. From the Run menu select "Run..." 
   
   Image Added
   
   
3. You will get a Run window pop-up, from there select Java Application.
   1. Click on New button in botton left
   2. Name the Project: any name you like, for example if you want to run the FilePoller application call it "filepoller".
   3. Click on arguments button:
   enter path of servicemix.xml file you want, e.g.,
   1. 1. In the Program Arguments box enter servicemix.xml
      2. In the Working Directory enter the path of your example. Such as:
         C:\Program Files\servicemix-1.0.1\examples\file-binding
         You can use the "File System..." button to browse for your directory.
   2. Click Apply.
   3. Click Run 
      
      Image Added
      
      

Configuring Eclipse

Updating Eclipse from Trunk

1. Browse the "Project" menu and select "Properties" 
   
   Image Added
   
   
2. Click "Java BuildPath" and under the "Libraries" tab click "Add External Jar". 
   
   Image Added
   
   
3. Browse to the incubator-servicemix-3.0-SNAPSHOT.jar location:
   Click Run \target\incubator-servicemix-3.0-SNAPSHOT\bin\incubator-servicemix-3.0-SNAPSHOT and Click "Open" then "OK" in the "Properties" screen 
   
   Image Added
   
   
4. Allow some time for the individual projects to build.