This page was mainly written to understand how OpenESB can be deployed on Glassfish v3 and to use it in a simple way.

Internal architecture

Since version 3, Glassfish is running on top of OSGI (Felix implementation) and the HK2 project.

For the OpenESB part, sole the core runtime is a pure OSGI bundle bootstrapper. All the needed libraries and additional components are deployed in an old fashion way by extending the OSGI module classloader (required by the JBI v1 specification). In this way, the global installation requirements are well-known from OpenESB v2.x users who are still using the Glassfish v2 container.

Installation of Glassfish v3

OpenESB is fully tested using the latest version of Glassfish v3 ( which can be found at

Using the OpenESB Bundle

A zip distribution is available and contains Glassfish v3 ( and the OpenESB runtime.

You just have to extract the distribution and run it .

This bundle can be downloaded from OpenESB Glassfish v3 Distribution

From an existing GFv3 installation

First, you have to deploy OpenESB Glassfish v3 Service into ${GLASSFISH_HOME}/modules 

Next step is to download the latest version of the OpenESB runtime and deploy it under ${GLASSFISH_HOME}/jbi (Please create the jbi folder if it doesn't exist).

Finally, just copy the OpenESB Glassfish v3 Framework into ${GLASSFISH_HOME}/jbi

Running Glassfish v3

As usual, you can start the Glassfish v3 server by running :

asadmin start-domain

In the same way, you can stop the Glassfish v3 server by running :  

asadmin stop-domain

Please do not use startserv / stopserv commands to start and stop your Glassfish v3 instance since these commands are not suitable to run well through the Glassfish v3 lifecycle used by OpenESB runtime.

Installing components

Before going further, be sure that you have started Glassfish v3 a first time to be able to deploy components !

The simplest way to deploy JBI components is to copy files to the autodeploy and autoinstall folders in ${GLASSFISH_HOME}/domains/domain1/jbi.

Be careful that you will probably have to install shared libraries before installing JBI components as well !