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
Description | Links | JIRA |
---|---|---|
Unable to deploy a JBI components due to a JBoss Classloading issue | https://community.jboss.org/thread/230132 | - OEJBOSS-7Getting issue details... STATUS |
Logger's level not persisted after restart | - OEJBOSS-9Getting issue details... STATUS |