Introduction

ModuleFusion incorporates Pax Runner to easily integrate different OSGi implementations and common bundles. While Pax Runner provides several implementations, ModuleFusion is only tested with Eclipse Equinox and Apache Felix. While both implement the OSGi Service Platform version 4.1 specification they still differ in the available feature set and behaviour.

Eclipse Equinox adds additional class loading mechanisms like the buddy class loading or a sophisticated extensibility with adapter hooks. Apache Felix tries to be a very clean and close to the spec implementation and e.g. provides very detailed error messages to help during the development.

Please check their homepage for a more detailed information.

Please note: ModuleFusion does not use any proprietary features of Equinox or Felix nor does it depend on a specific behaviour of these implementations. ModuleFusion only depends on the OSGi Service Platform specification and is implementation-agnostic.

Download and Start ModuleFusion

The ModuleFusion distribution is divided into a core "runtime" and "feature packs" (currently Hibernate and Wicket) modules.

Download "modulefusion-runtime-version.zip" and, depending on the desired feature packs, "modulefusion-featurepack-name-version.zip" and unzip them into a new directory. Make sure that you unzip the feature pack within the "modulefusion/load" directory created by the runtime zip file.

Change into the directory "modulefusion" and run

"./modulefusion.(sh|bat)"

By default, Apache Felix will be used. The runtime can be changed by setting the --platform (short --p) parameter. E.g. to use Eclipse Equinox, run

"./modulefusion.(sh|bat) --p=e"

This parameter is used by Pax Runner. All available parameter are described here: wiki.ops4j.org/confluence/display/ops4j/

Verify the Installation

To verify the installation open a browser and open the URL http://localhost:8080/helloworld/. This URL points to a sample application that ships with ModuleFusion. You should see the message "Hello World!" in your browser.

Next Steps

• Take a look at the example applications and how to build and extend them
• See here how to add more bundles and configurations