Installing JBoss ESB in JBoss AS 5.1

We will see the steps to install JBoss ESB in a JBoss AS instance. The ESB can be run in a standalone mode which we are not analyzing in this post. The steps to install the JBoss ESB are really simple and the installation already includes JBPM3 within it. In another post we will see different ESB examples.

Versions used:

JBoss AS 5.1.0.GA - Download
JBoss ESB 4.11 Community - Download
Eclipse Indigo SR2 - Download
JBoss Tools 3.3 for SOA - Download
Ant 1.8.4 - Download


Create a new JBoss instance, we will create esb-default based on default

cd /opt/jboss/server
cp default esb-default -r

In your download folder, extract the JBoss ESB zip file:

cp jbossesb-4.11.zip /opt
cd /opt/jbossesb-4.11
unzip jbossesb-4.11.zip

Now, let's get into the install directoy and create a new deployment.properties file

cd /opt/jbossesb-4.11/install/
cp deployment.properties-example deployment.properties

Now edit the new deployment.properties file and modify the following lines:

org.jboss.esb.server.config=default
...
org.jboss.esb.server.home=/jbossesb-server-4.5.GA

to these

org.jboss.esb.server.config=esb-default
...
org.jboss.esb.server.home=/opt/jboss-5.1.0.GA

Now, while in the install directory let's install the ESB in the AS:

ant deploy

To run the server:

./run.sh -c esb-default

In Eclipse IDE with JBoss Tools installed, in order to create a new ESB example:
File -> New -> Other -> ESB Project

In target runtime create a new server based on your esb-default instance. At the end of the wizard, choose Server Supplied ESB Runtime (because we've installed the ESB in the JBoss esb-default instance)

The following guides are essential while working with JBoss ESB:
ESB Tools Reference Guide
ESB Services Guide
ESB Programmers Guide