Developer Guide

Development

Source code

Git repository: https://bitbucket.org/openesb/openesb-jboss-v7

Continuous Integration

The job is available at: http://build.open-esb.net:8080/jenkins/view/JBoss/job/openesb-jboss-v7/

Build status : 

How-to build

Simply by running:

mvn clean install

Installation

JBoss AS 7

Download and extract JBoss AS 7 (latest is 7.1.1.Final): http://download.jboss.org/jbossas/7.1/jboss-as-7.1.1.Final/jboss-as-7.1.1.Final.zip

OpenESB Subsystem Extension

Download and install

Download OpenESB extension for JBoss AS 7: http://build.open-esb.net:8080/jenkins/view/JBoss/job/openesb-jboss-v7/lastSuccessfulBuild/artifact/jboss7-subsystem/target/module/net/openesb/jboss7/main/

Copy module.xml and openesb-jboss7-subsystem.jar to $JBOSS_HOME/modules/net/openesb/jboss7/main (the first time, you have to create repositories).

Declare the OpenESB extension

To declare the OpenESB extension to the JBoss AS7 module system, you have to add the following line to the $JBOSS_HOME/standalone/configuration/standalone.xml:

<server>
	<extensions>
		...
		<extension module="org.jboss.as.weld"/>
        <extension module="net.openesb.jboss7"/>
	</extensions>
	...
	<profile>
		...
		<subsystem xmlns="urn:jboss:domain:weld:1.0"/>
        <subsystem xmlns="urn:com.openesb.jboss:1.0"/>
    </profile>
</server>

OpenESB Runtime

JBoss / Wildfly OpenESB extension is working only with OpenESB Core starting from 2.4.1 !

 

jbi_rt.jar / jbi-ext.jar and jbi.jar must be installed into $JBOSS_HOME/modules/net/openesb/jboss7/main

At this point, your $JBOSS_HOME/modules/net/openesb/jboss7/main directory must contain the following files :

~/java-ext/jboss/jboss-as-7.1.1.Final/modules/net/openesb/jboss7/main > ls -l
total 4304
-rw-r--r--  1 david  staff    22813  2 jul 05:04 jbi-ext.jar
-rw-r--r--  1 david  staff    19364  2 jul 05:04 jbi.jar
-rw-r--r--@ 1 david  staff  2123688 24 mai 17:04 jbi_rt.jar
-rw-r--r--  1 david  staff      766  5 jul 10:58 module.xml
-rw-r--r--  1 david  staff    27567  5 jul 13:09 openesb-jboss7-subsystem.jar

Playing with OpenESB and JBoss AS 7

Start / stop JBoss AS 7

# To start JBoss (Unix systems)
./bin/standalone.sh
 
# To start JBoss (Windows)
./bin/standalone.bat

Configure Logger level

To configure the loggers, take a look to $JBOSS_HOME/standalone/configuration/standalone.xml

In this file, you can configure all log level for OpenESB like this :

<subsystem xmlns="urn:jboss:domain:logging:1.1">
	...
	<!-- Add one or many logger for OpenESB -->
	<logger category="com.sun.jbi">
		<level name="FINE"/>
	</logger>
 
	<logger category="com.sun.jbi.management">
		<level name="WARNING"/>
	</logger>
	...
	<root-logger>
		<level name="INFO"/>
		<handlers>
			<handler name="CONSOLE"/>
			<handler name="FILE"/>
		 </handlers>
	</root-logger>
</subsystem>

Ok, but I want to play with OpenESB !

The first time you're starting JBoss AS 7 with the OpenESB extension, a new directory called jbi under $JBOSS_HOME/standalone is created.

Now you can go ahead and take a look to Common Installation Steps

Issues

DescriptionLinksJIRA
Unable to deploy a JBI components due to a JBoss Classloading issuehttps://community.jboss.org/thread/230132 OEJBOSS-7 - Getting issue details... STATUS
Logger's level not persisted after restart  OEJBOSS-9 - Getting issue details... STATUS