|Join wMUsers | Blog at wMUsers | User Control Panel | Site Map | webMethods Jobs |For Employers|
webMethods recently annoucned that it will integrate the JBoss application server directly into the webMethods integration platform in a future release. The stated purpose of this major move is to allow users to "exploit the strength of the J2EE-based development paradigm to complement their integration logic".
A few of the practical benefits of embedding JBoss into webMethods Integration Server (IS) include:
The integrated version of webMethods 6 is supposed to be generally available around mid-year 2003 either as an add-on to version 6 or as part of a future release. However, you don’t have to wait until then to realize many of the benefits of the embedded solution.
The purpose of this article is to provide step-by-step instructions on how to integrate webMethods 6 with JBoss 3.x using version 1.2 of the Integration Server’s EJB Adapter so that you can begin learning about how to access EJB’s deployed in the JBoss EJB container from your IS flow services.
Specifically, I’ll provide steps and screenshots to help you do the following:
What You’ll Need Before Starting
How to Install JBoss 3.04
First, unzip the JBoss / Tomcat bundle to the desired installation directory. I usually choose the root directory of my second hard drive, but you can use any valid path. Be sure to choose the "use folder names" option to preserve the path names during the unzip.
Next, rename the top level JBoss folder to something simpler than JBoss-3.0.4_Tomcat-4.1.12 (I renamed mine JBoss3) and copy the contents of the jboss_home\server\minimal to jboss_home\server\your_config_name. This creates a duplicate JBoss configuration in which you can experiment without messing up the default configuration.
To increase the amount of built-in applications that load with your server, choose the default folder instead of the minimal folder.
The JBoss directory structure should resemble the following:
Next, create a NT batch file named "runJBoss.cmd" and start the JBoss Server by executing it. The batch file commands are listed below. Be sure to specify the proper directory structure.
D:\ CD d:\jboss3\bin start "Mark's JBoss Config" run.bat -c your_config_name
Once executed, the batch file will generate several screens full of INFO and WARN-level messages, but no ERROR messages. The last message will resemble this one and indicates success:
"[Server] JBoss (MX MicroKernel) [3.0.4 Date:200211021607] Started in 0m:9s:524ms"
Download the accompanying code for this article and copy /pub/wmUsersEJB.jar to your JBoss /deploy directory. This will automatically deploy the EJB. To uninstall it, just delete the wmUsersEJB.jar from the folder. To deploy a new version, just paste a new version over the old one. It’s that simple!
To confirm that the EJB was successfully deployed, view the JBoss console log. The messages should be similar to these:
19:04:42,860 INFO [MainDeployer] Starting deployment of package: file:/D:/jboss3/server/mark/deploy/wmUsersEJB.jar 19:04:42,980 INFO [EjbModule] Creating 19:04:42,990 INFO [EjbModule] Deploying wmUsers 19:04:43,010 INFO [EjbModule] Created 19:04:43,010 INFO [EjbModule] Starting 19:04:43,020 INFO [EjbModule] Started 19:04:43,020 INFO [MainDeployer] Deployed package: file:/D:/jboss3/server/mark/deploy/wmUsersEJB.jar
Because the webMethods EJB Adapter requires a local copy of the jar, remember to copy wmUsersEJB.jar to the webMethods JAR directory. For webMethods Integration Server v4.6, this folder is install_dir\lib\jars directory; for webMethods 6, it is install_dir\lib\system.
Mark Carlson is the president and principal solutions architect of Conneva, Inc. which specializes in the design and development of webMethods-based integration architectures. Mark has over 18 years of experience in the IT industry and has worked with webMethods products for the past 3 years. Mark and his family live in Evergreen, Colorado at 8,000 feet above sea level.
Mark can be reached via email at
|© All Rights Reserved, 2001-2008.|