Registry Configuration



By: Kurt Stam (kurt.stam@jboss.com)

 

JBoss ESB JBoss Labs Home Page: http://labs.jboss.com/portal/jbossesb

 

JBoss ESB Developer Community Forums: http://www.jboss.com/index.html?module=bb&op=viewforum&f=220

 

########################################################################

# JBoss, Home of Professional Open Source

# Copyright 2006, JBoss Inc., and individual contributors as indicated

# by the @authors tag. See the copyright.txt in the distribution for a

# full listing of individual contributors.

#

# This is free software; you can redistribute it and/or modify it

# under the terms of the GNU Lesser General Public License as

# published by the Free Software Foundation; either version 2.1 of

# the License, or (at your option) any later version.

#

# This software is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

# Lesser General Public License for more details.

#

# You should have received a copy of the GNU Lesser General Public

# License along with this software; if not, write to the Free

# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA

# 02110-1301 USA, or see the FSF site: http://www.fsf.org.

########################################################################

 

 





Four Simple Steps to get up and running.

  1. I'm assuming you have ant (1.6.5 or higher) and java5 installed on your machine, and that you have a fresh copy of jboss 4.0.x. So now go and download the JBossESB 4.0RC1 distribution from http://labs.jboss.com/portal/jbossesb/downloads

  2. Unzip the file to a directory of your choice and go into the 'install' directory to find the deployment.properties-example. Copy and rename this file to deployment.properties and edit the following lines:

    # application server root directory

org.jboss.esb.appserver.home=C:/cygwin/home/kstam/apps/jboss-4.0.4.GA/jbossesb

# the instance of jboss you are running (default)

org.jboss.esb.appserver.config=default

#the place where the jboss libraries can be found

org.jboss.esb.dist.lib=../jbossesb/lib


  1. Run 'ant configure'. This will deploy the esb to your jboss AS instance. It copies the jbossesb.sar directory into your deploy directory.

  2. Start your appserver and see the JBossESB heartbeat:

    11:37:35,546 INFO [Server] JBoss (MX MicroKernel) [4.0.4.GA (build: CVSTag=JBoss_4_0_4_GA date=200605151000)] Started in 23s:843ms

11:37:50,375 INFO [EsbListenerController] Reloading parameters _____________________________________________________

11:38:10,390 INFO [EsbListenerController] Reloading parameters _____________________________________________________

11:38:20,421 INFO [GatewayListenerController] Reloading parameters _____________________________________________________

11:38:20,453 WARN [GatewayListenerController] No value specified for: endTime - Will run forever (or until interrupted by user)



That's it. You've done it :).



Note that in your server/default/conf directory you now have 2 new configuration files:

jbossesb-listener.xml
jbossesb-gateway.xml

You can add xml fragments in there and when the controller reload your listeners and gateways come up !!! So try pasting in xml from the Hello World config sample. When the listeners reload their parameters it will get picked up dynamically. Note that gateways reference listeners, so add the listeners first.

Finally note that the jbossesb.sar is pretty basic and if you want to use smooks, or jboss-rules for content-based-routing you will have to add them. More detailed instructions can be found elsewhere.