This document will guide you through mporting ServiceMix nto the IDE Eclipse.


This documentation applies to ServiceMix versions prior to 3.0 release. For v3.0, please refer to the User's Guide, chapter Importing ServiceMix into Eclipse.

Pre-Installation Requirements


  • 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.


  • 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.

    mvn eclipse:eclipse

In Eclipse:

  1. From the "File" menu select "Import". 

  2.  elect "Existing Projects into Workspace" and click "Next" 

  3. Browse for the root directory, which is the directory in which you downloaded ServiceMix. "Select 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. 

  4. From the "Windows" enu and click "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. 

  5. Then check under "Installed JREs" that you have JDK 5, e.g., jre_1.5.x 

  6. Click on the Java plus sign, then click on Build Path
    then select Classpath Variables. 

  7. Click on New button to right

    A pop-up appears.
    Enter the Name: M2_REPO
    Enter the Path, which is your local maven repository, usually located in
    your home directory .m2, for example:
    C:\Documents and Settings\gnodet\.m2\repository 

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/
    Double click on the main() class. 

  2. From the Run menu select "Run..." 

  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:

      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.

    4. Click Apply.

    5. Click Run 

Configuring Eclipse

Updating Eclipse from Trunk

  1. Browse the "Project" menu and select "Properties" 

  2. Click "Java BuildPath" and under the "Libraries" tab click "Add External Jar". 

  3. Browse to the incubator-servicemix-3.0-SNAPSHOT.jar location:
    \target\incubator-servicemix-3.0-SNAPSHOT\bin\incubator-servicemix-3.0-SNAPSHOT and Click "Open" then "OK" in the "Properties" screen 

  4. Allow some time for the individual projects to build.