Setup the environment

Updated environment setup script

Because new versions of the tools and frameworks we use in the examples keep coming, we decided to create an updated environment setup script. This updated script is a bit larger, because we removed the automatic downloads and switched to an offline mode, with all the tools and frameworks already downloaded. You can choose to download the whole environment at once, but notice this is quite a large file (around 410 mb). You can also choose to download the environment script and the tools and frameworks separately.

Download whole environment at once

  • Download the full environment at once (around 410 mb)


  • Download environment in separate steps

    If you want to download the book's environment script and the tools and frameworks separately, be sure to store the zip and jar files of the tools and frameworks in the work/downloads sub-directory of the extracted book's environment script install directory

  • Download the book's environment script (47 mb)


  • ESBs

  • Download Mule 2.0.2 (or go to the MuleSource release website, look for previous versions)
  • Download ServiceMix 3.2.1 (or go to the Apache ServiceMix release website)


  • Tools

  • Download Anomic FTP v0.93 (or go to the Anomic FTP release website)
  • Download Apache ActiveMQ 4.1.2 (or go to the Apache ActiveMQ release website)
  • Download eXist 1.2.0 rev7233 (or go to the eXist release website, only latest version 1.2.x available)
  • Download HSQLDB 1.8.0.9 (or go to the HSQLDB release website, only latest version 1.8.0.x available)
  • Download James mail server 2.3.1 (or go to the Apache James release website)
  • Download Apache OpenEJB 3.0 (or go to the Apache OpenEJB 3.0 website, download the standlone server)


  • Libraries

  • Download Hibernate 3.2.6 (or go to the Hibernate release website)
  • Download Ant Contrib 1.0b2 (or go to the Apache ActiveMQ release website)
  • Download SVNKit 1.1.8 (or go to the SVNKit release website, look for older versions)
  • Download Apache CXF 2.0.7 (or go to the Apache CXF 2.0.7 release website)
  • Download JiBX 1.1.6a (or go to the JiBX release website)
  • Download Mail 1.4 API (or go to the Mail 1.4 API Maven repository)
  • Download Beanshell 2.0b4 (or go to the Beanshell release website)
  • Download Spring framework 2.0.8 with dependencies (or go to the Spring release website)
  • Download Apache Ode 1.2 (or go to the Apache Ode release website)


  • Get your development environment installed

    When you extracted the book's large environment script or downloaded the frameworks and tools individually to the work/downloads directory, you should have the following directory structure

  • boxResources (with the petals file etc)
  • osesb-test-client (the Swing test client)
  • prepareResources (including the prepare.properties file)
  • work (with the downloads directory)
  • workspace (with Mule and ServiceMix sources)
  • build.xml (Ant build file to setup the environment)


  • Before executing the Ant build file, set the root directory where you want the environment script to execute. Open the prepareResources/prepare.properties file and change the installation.target property to the installation directory of the environment script. Note that you should use a forward slash (/) for both Windows (so c:/osesbinaction) as well as Linux/Unix systems. Also be sure to install Apache Ant 1.7 or later and add the bin directory to your environment path. Now execute the Ant build file from a command prompt, by just executing the ant command and the environment is being prepared for you

    To get the Mule and ServiceMix projects loaded in Eclipse, you can choose to open an existing project and go to the workspace/mule-workspace or workspace/servicemix-workspace directory. There you will find respectively the mule and servicemix project, which you can directory load into Eclipse. The classpath is already set in the Ant script, so you are ready to go!

    Only get the source code

    The source code of the Mule and ServiceMix examples is also available via Google Code. We have a seperate code repository for the Mule and ServiceMix examples:

    Mule Google Code repository

    ServiceMix Google Code repository