Hi,
As part of this article we will see how to configure a JMS Message bridge on WebLogic 12c side so that any message sent to the JMS Queue present on WebLogic will be automatically transfered to WildFly 8.2 Instance. The WebLogic Messaging Bridge is a forwarding mechanism that provides interoperability between WebLogic JMS implementations, and between JMS and other messaging products. We are going to use the Messaging Bridge to integrate WildFly 8.2 offered HornetQ messaging broker communication. A messaging bridge instance forwards messages between a pair of bridge source and target destinations. These destinations are mapped to a pair of bridge source and target destinations. The messaging bridge reads messages from the source bridge destination and forwards those messages to the target bridge destination.
In order to know how to create a WebLogic Message bridge between WebLogic and JBoss 5 please refer to : http://middlewaremagic.com/weblogic/?p=6066
As part of this article we will learn:
1). How to create a WebLogic Message Bridge using WLST.
2). How to create a JMS Queue on WildFly 8.2 side.
NOTE: These steps will remain almost same for JBoss AS7 or JBoss EAP6, the only change will be in the Connection URL of WildFly or JBossAS. In WildFly we use “http-remoting://localhost:8080” where as in JBossAS7/EAP6 we use “remote://localhost:4447”).
3). Then we will send some messages to WebLogic JMS Queues and will receive them from WildFly 8.2 JMS Queues.
Creating A Simple JMS Queue on WildFLy 8.2 side
Step-1). Start the WildFly 8.2 (or JBoss EAP6/JBossAS7) full profile (which has messaging) as following:
$ cd /PATH/TO/wildfly-8.2.1.Final/bin $ ./standalone.sh -c standalone-full.xml
I am running Weblogic 12c and WildFLy on the same host hence i am running both on “localhost” users can change it based on their need.
Step-2). Create a simple JMS user on WildFly 8.2 side and this user must belong to “guest” role. Please see the “messaging subsystem” configuration of “standalone-full.xml” to know more about “guest” role.
username: jmsuser
password: jmsuser@123
user role: guest
Realm: ApplicationRealm
$ cd /PATH/TO/wildfly-8.2.1.Final/bin $ ./add-user.sh What type of user do you wish to add? a) Management User (mgmt-users.properties) b) Application User (application-users.properties) (a): b Enter the details of the new user to add. Using realm 'ApplicationRealm' as discovered from the existing property files. Username : jmsuser Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file. - The password should not be one of the following restricted values {root, admin, administrator} - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s) - The password should be different from the username Password : jmsuser@123 Re-enter Password : jmsuser@123 What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[ ]: guest About to add user 'jmsuser' for realm 'ApplicationRealm' Is this correct yes/no? yes Added user 'jmsuser' to file '/PATH/TO/wildfly-8.2.1.Final/standalone/configuration/application-users.properties' Added user 'jmsuser' to file '/PATH/TO/wildfly-8.2.1.Final/domain/configuration/application-users.properties' Added user 'jmsuser' with groups guest to file '/PATH/TO/wildfly-8.2.1.Final/standalone/configuration/application-roles.properties' Added user 'jmsuser' with groups guest to file '/PATH/TO/wildfly-8.2.1.Final/domain/configuration/application-roles.properties' Is this new user going to be used for one AS process to connect to another AS process? e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server EJB calls. yes/no? yes To represent the user add the following to the server-identities definition <secret value="am1zdXNlckAxMjM=" />
Step-3). Creating a simple JMS Queue using the WildFly CLI command line utility. NOTE the JNDI name should contain “java:/jboss/exported” prefix or else the JMS queue will can not be looked up remotely.
$ cd /PATH/TO/wildfly-8.2.1.Final/bin $ ./jboss-cli.sh -c [standalone@localhost:9990 /] /subsystem=messaging/hornetq-server=default/jms-queue=TestQ/:add(entries=["java:/jboss/exported/jms/queue/TestQ"],durable=false) {"outcome" => "success"} [standalone@localhost:9990 /] :reload { "outcome" => "success", "result" => undefined }
Starting WebLogic 12c and configuring it
First of all Copy the WildFly client jar “/PATH/TO/wildfly-8.2.1.Final/bin/client/jboss-client.jar” and place it inside the “$DOMAIN_HOME/lib” directory of WebLogic 12c.
Step-4). Start WebLogic 12c normally.
$ cp -f /PATH/TO/wildfly-8.2.1.Final/bin/client/jboss-client.jar /PATH/TO/wls12130/user_projects/domains/mydomain/lib $ cd /PATH/TO/wls12130/user_projects/domains/mydomain/bin $ ./startWebLogic.sh
Writing WLST script to configure JMS Bridge
Step-5). Now create a directory like “WebLogic_JMS_Bridge” where we will place our project artifacts.
$ mkdir WebLogic_JMS_Bridge $ cd WebLogic_JMS_Bridge
Step-6). Inside the “WebLogic_JMS_Bridge” directory write the following kind of file “domain.properties” which will contain all the configuration details.
############ WebLogic 12c JMS Queue and Connection Factory related Configuration ######### # 1 - Connecting details server.url = t3://localhost:7001 username = weblogic password = weblogic1 # 2 - JMSServer details jms.server.name = My_JMSServer store.name = MyJDBCStore tragated.jms.server.name = myserver # 3 - SystemModule Details system.module.name = My_SystemModule tragated.system.module.name = myserver # 4 - ConnectionFactory Details connection.factory.name = My_ConnectionFactory connection.factory.jndi.name = My_CF # 5 - Unit Of Order Details unit.of.order.value = 1 # 6 - SubDeployment & Queue Details queue.sub.deployment.name = Sub_My_Queue queue.name = My_Queue queue.jndi.name = My_Q ############ JMS Bridge related Configuration ######### weblogic.destination.bridge = WLS_Source_Bridge weblogic.adapter.jndi.name = eis.jms.WLSConnectionFactoryJNDINoTX wildfly.destination.bridge = WildFly_Destination_Bridge wildfly.server.url = http-remoting://localhost:8080 # When using JBoss EAP6 or JBossAS7 then change the URL to following: # wildfly.server.url =remote://localhost:4447 wildfly.initial.context.factory = org.jboss.naming.remote.client.InitialContextFactory wildfly.remote.connection.factory.jndi.name = jms/RemoteConnectionFactory wildfly.jms.destination.jndi.name = jms/queue/TestQ wildfly.jms.username = jmsuser wildfly.jms.password = jmsuser@123
Step-7). Now we will write simple WLST Script to configure the JMS Bridge , Create JMS Queue, JMS ConnectionFactory on WebLogic side. So write a file like “weblogicJMS_Setup.py” inside the same directory “WebLogic_JMS_Bridge” as following:
############################################################################# # # @author Copyright (c) 2010 - 2011 by Middleware Magic, All Rights Reserved. # ############################################################################# from java.io import FileInputStream import java.lang import os import string propInputStream = FileInputStream("domain.properties") configProps = Properties() configProps.load(propInputStream) # 1 - Connecting details serverUrl = configProps.get("server.url") Username = configProps.get("username") Password = configProps.get("password") # 2 - JMSServer details jmsServerName = configProps.get("jms.server.name") storeName = configProps.get("store.name") tragatedJMSServerName = configProps.get("tragated.jms.server.name") # 3 - SystemModule Details systemModuleName = configProps.get("system.module.name") tragatedSystemModuleName = configProps.get("tragated.system.module.name") # 4 - ConnectionFactory Details connectionFactoryName = configProps.get("connection.factory.name") ConnectionFactoryJNDIName = configProps.get("connection.factory.jndi.name") # 5 - Unit Of Order Details unitOfOrderValue = configProps.get("unit.of.order.value") # 6 - SubDeployment & Queue Details queueSubDeploymentName = configProps.get("queue.sub.deployment.name") queueName = configProps.get("queue.name") queueJNDIName = configProps.get("queue.jndi.name") #7 - Weblogic Bridge Details: weblogicDestinationBridge = configProps.get("weblogic.destination.bridge") weblogicAdapterJNDINoTX = configProps.get("weblogic.adapter.jndi.name") #8 - Widlfly bridge details: wildflyDestinationBridge = configProps.get("wildfly.destination.bridge") wildflyServerUrl = configProps.get("wildfly.server.url") wildflyJMSUsername = configProps.get("wildfly.jms.username") wildflyJMSUserPassword = configProps.get("wildfly.jms.password") wildflyInitialContextFactory = configProps.get("wildfly.initial.context.factory") wildflyJMSConnectionFactory = configProps.get("wildfly.remote.connection.factory.jndi.name") wildflyJMSQueueJndi = configProps.get("wildfly.jms.destination.jndi.name") redirect('wlst.log','false') # 1 - Connecting to the Destination connect(Username,Password,serverUrl) edit() # 2 - JMSServer details print "================== JMSSever ===================" startEdit() cmo.createJMSServer(jmsServerName) print "Created a JMSServer !!" cd('/Deployments/'+jmsServerName) cmo.setPersistentStore(getMBean('/FileStores/'+storeName)) print "PersistentStore has been set for the JMSServer !!" set('Targets',jarray.array([ObjectName('com.bea:Name='+tragatedJMSServerName+',Type=Server')], ObjectName)) print "Targeted the JMSServer !!" activate() print "" # 3 - SystemModule Details print "================== SystemModule ===================" startEdit() cd('/') cmo.createJMSSystemResource(systemModuleName) print "Created a SystemModule !!" cd('/SystemResources/'+systemModuleName) set('Targets',jarray.array([ObjectName('com.bea:Name='+tragatedSystemModuleName+',Type=Server')], ObjectName)) print "Targeted the SystemModule !!" activate() print "" # 4 - ConnectionFactory Details print "================== ConnectionFactory ===================" startEdit() cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName) cmo.createConnectionFactory(connectionFactoryName) cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName+'/ConnectionFactories/'+connectionFactoryName) cmo.setJNDIName(ConnectionFactoryJNDIName) print "Created a ConnectionFactory !!" cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName+'/ConnectionFactories/'+connectionFactoryName+'/SecurityParams/'+connectionFactoryName) cmo.setAttachJMSXUserId(false) cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName+'/ConnectionFactories/'+connectionFactoryName) cmo.setDefaultTargetingEnabled(true) print "Targeted the ConnectionFactory !!" activate() print "" # 5 - Unit Of Order Details print "================== Unit Of Order ===================" startEdit() cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName+'/ConnectionFactories/'+connectionFactoryName+'/DefaultDeliveryParams/'+connectionFactoryName) cmo.setDefaultUnitOfOrder(unitOfOrderValue) print "Changed Unit Of Order !!" activate() print "" # 6 - SubDeployment & Queue Details print "================== SubDeployment & Queue ===================" startEdit() cd('/SystemResources/'+systemModuleName) cmo.createSubDeployment(queueSubDeploymentName) print "Created a SubDeployment for Queue !!" cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName) cmo.createQueue(queueName) print "Created a Queue !!" cd('/JMSSystemResources/'+systemModuleName+'/JMSResource/'+systemModuleName+'/Queues/'+queueName) cmo.setJNDIName(queueJNDIName) cmo.setSubDeploymentName(queueSubDeploymentName) cd('/SystemResources/'+systemModuleName+'/SubDeployments/'+queueSubDeploymentName) set('Targets',jarray.array([ObjectName('com.bea:Name='+jmsServerName+',Type=JMSServer')], ObjectName)) print "Targeted the Queue to the created subdeployment !!" activate() print "" print "================== Creating WebLogic Destination Bridge ===================" startEdit() cd('/') cmo.createJMSBridgeDestination(weblogicDestinationBridge) cd('/JMSBridgeDestinations/'+weblogicDestinationBridge) cmo.setConnectionURL(serverUrl) cmo.setAdapterJNDIName(weblogicAdapterJNDINoTX) cmo.setConnectionFactoryJNDIName(ConnectionFactoryJNDIName) cmo.setDestinationJNDIName(queueJNDIName) activate() print "================== Creating WildFly Destination Bridge ===================" startEdit() cd('/') cmo.createJMSBridgeDestination(wildflyDestinationBridge) cd('/JMSBridgeDestinations/'+wildflyDestinationBridge) cmo.setConnectionURL(wildflyServerUrl) cmo.setAdapterJNDIName(weblogicAdapterJNDINoTX) cmo.setConnectionFactoryJNDIName(wildflyJMSConnectionFactory) cmo.setDestinationJNDIName(wildflyJMSQueueJndi) activate() startEdit() cd('/JMSBridgeDestinations/'+weblogicDestinationBridge) cmo.setUserName(Username) cmo.setUserPassword(Password) activate() startEdit() cd('/JMSBridgeDestinations/'+wildflyDestinationBridge) cmo.setUserName(wildflyJMSUsername) cmo.setUserPassword(wildflyJMSUserPassword) cmo.setInitialContextFactory(wildflyInitialContextFactory); activate() print "================== Creating JMS Bridge on WebLogic12c ===================" startEdit() cd('/') cmo.createMessagingBridge('WLS12c_to_WildFly8_Bridge') cd('/MessagingBridges/WLS12c_to_WildFly8_Bridge') set('Targets',jarray.array([ObjectName('com.bea:Name=myserver,Type=Server')], ObjectName)) cmo.setSourceDestination(getMBean('/JMSBridgeDestinations/'+weblogicDestinationBridge)) cmo.setTargetDestination(getMBean('/JMSBridgeDestinations/'+wildflyDestinationBridge)) cmo.setStarted(true) cmo.setSelector('') cmo.setQualityOfService('Atmost-once') activate() cmd = "rm -f wlst.log" os.system(cmd)
Step-8). Now we will run the WLST script. As following:
$ cd /PATH/TO/wls12130/user_projects/domains/mydomain/bin $ . ./setDomainEnv.sh $ cd /PATH/TO/WebLogic_JMS_Bridge $ java weblogic.WLST webLogicJMS_Setup.py OUTPUT: Initializing WebLogic Scripting Tool (WLST) ... Welcome to WebLogic Server Administration Scripting Shell Type help() for help on available commands ================== JMSSever =================== Created a JMSServer !! PersistentStore has been set for the JMSServer !! Targeted the JMSServer !! ================== SystemModule =================== Created a SystemModule !! Targeted the SystemModule !! ================== ConnectionFactory =================== Created a ConnectionFactory !! Targeted the ConnectionFactory !! ================== Unit Of Order =================== Changed Unit Of Order !! ================== SubDeployment & Queue =================== Created a SubDeployment for Queue !! Created a Queue !! Targeted the Queue to the created subdeployment !! ================== Creating WebLogic Destination Bridge =================== ================== Creating WildFly Destination Bridge =================== ================== Creating JMS Bridge on WebLogic12c ===================
Writing Java Code to send messages to WebLogic JMS Queue
Step-9). Now In the “WebLogic_JMS_Bridge” create a sub directory with name “src” where we will create file “QueueSend.java”:
import java.io.IOException; import java.util.Hashtable; import javax.jms.JMSException; import javax.jms.Queue; import javax.jms.QueueConnection; import javax.jms.QueueConnectionFactory; import javax.jms.QueueSender; import javax.jms.QueueSession; import javax.jms.Session; import javax.jms.TextMessage; import javax.naming.Context; import javax.naming.InitialContext; import javax.naming.NamingException; public class QueueSend { public final static String JNDI_FACTORY="weblogic.jndi.WLInitialContextFactory"; public final static String JMS_FACTORY="My_CF"; public final static String QUEUE="My_Q"; private QueueConnectionFactory qconFactory; private QueueConnection qcon; private QueueSession qsession; private QueueSender qsender; private Queue queue; private TextMessage msg; public void init(Context ctx, String queueName) throws NamingException, JMSException { qconFactory = (QueueConnectionFactory) ctx.lookup(JMS_FACTORY); qcon = qconFactory.createQueueConnection(); qsession = qcon.createQueueSession(false, Session.AUTO_ACKNOWLEDGE); queue = (Queue) ctx.lookup(queueName); qsender = qsession.createSender(queue); msg = qsession.createTextMessage(); qcon.start(); } public void send(String message,int counter) throws JMSException { msg.setText(message); msg.setIntProperty("counter", counter); qsender.send(msg); } public void close() throws JMSException { qsender.close(); qsession.close(); qcon.close(); } public static void main(String[] args) throws Exception { if (args.length != 1) { System.out.println("Usage: java QueueSend WebLogicURL"); return; } InitialContext ic = getInitialContext(args[0]); QueueSend qs = new QueueSend(); qs.init(ic, QUEUE); readAndSend(qs); qs.close(); } private static void readAndSend(QueueSend qs) throws IOException, JMSException { String line="Test Message Body with counter = "; for(int i=0;i<10;i++) { qs.send(line+i,i); System.out.println("JMS Message Sent: "+line+i+"\n"); } } private static InitialContext getInitialContext(String url) throws NamingException { Hashtable env = new Hashtable(); env.put(Context.INITIAL_CONTEXT_FACTORY, JNDI_FACTORY); env.put(Context.PROVIDER_URL, url); return new InitialContext(env); } }
Step-10). Now we will write a simple ANT “build.xml” file inside the “WebLogic_JMS_Bridge” as following:
<project name="ApplicationLevelJMSDemo" default="run"> <property name="wls.home" value="/Users/jsensharma/NotBackedUp/Installed/wls12130" /> <!-- CHANGE ME!! --> <property name="basedir" value="." /> <property name="tmp.dir" value="tmp" /> <property name="output.dir" value="build" /> <property name="src.dir" value="src" /> <property name="client.jar.name" value="jms_WLS_Client.jar" /> <path id="wls.classpath"> <fileset dir="${wls.home}"> <include name="**/*.jar"/> </fileset> </path> <target name="init"> <delete dir="${output.dir}" /> <mkdir dir="${output.dir}" /> <delete dir="${tmp.dir}" /> <mkdir dir="${tmp.dir}" /> </target> <target name="run"> <delete dir="${tmp.dir}" /> <mkdir dir="${tmp.dir}" /> <javac srcdir="${src.dir}" destdir="${tmp.dir}" includes="QueueSend.java" classpathref="wls.classpath"/> <jar jarfile="${output.dir}/${client.jar.name}" basedir="${tmp.dir}" compress="true" /> <java classname="QueueSend" fork="true"> <classpath> <pathelement location="${tmp.dir}"/> <path refid="wls.classpath"/> </classpath> <arg value="t3://localhost:7001"/> </java> <delete dir="${tmp.dir}" /> </target> </project>
Make sure to change the “wls.home” to point to your own WebLogic installation in this file.
Step-11). Now lets run the ANT project to send some messages to WLS “My_Q”
$ cd /PATH/TO/WebLogic_JMS_Bridge $ export ANT_HOME=/PATH/TO/apache_ant_1.9.2 $ export JAVA_HOME=/PATH/TO/jdk1.8.0_60 $ export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH $ ant OUTPUT: Buildfile: /Users/jsensharma/NotBackedUp/MM_Tests/WLS/JMS_Bridge/build.xml run: [mkdir] Created dir: /PATH/TO/WebLogic_JMS_Bridge/tmp [javac] /Users/jsensharma/NotBackedUp/MM_Tests/WLS/JMS_Bridge/build.xml:28: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds [javac] Compiling 1 source file to /PATH/TO/WebLogic_JMS_Bridge/tmp [javac] warning: Supported source version 'RELEASE_6' from annotation processor 'org.eclipse.persistence.internal.jpa.modelgen.CanonicalModelProcessor' less than -source '1.8' [javac] warning: Supported source version 'RELEASE_6' from annotation processor 'org.sonatype.guice.bean.scanners.index.SisuIndexAPT6' less than -source '1.8' [javac] Note: /PATH/TO/WebLogic_JMS_Bridge/src/QueueSend.java uses unchecked or unsafe operations. [javac] Note: Recompile with -Xlint:unchecked for details. [javac] 2 warnings [jar] Building jar: /PATH/TO/WebLogic_JMS_Bridge/build/jms_WLS_Client.jar JMS Message Sent: Test Message Body with counter = 0 JMS Message Sent: Test Message Body with counter = 1 JMS Message Sent: Test Message Body with counter = 2 JMS Message Sent: Test Message Body with counter = 3 JMS Message Sent: Test Message Body with counter = 4 JMS Message Sent: Test Message Body with counter = 5 JMS Message Sent: Test Message Body with counter = 6 JMS Message Sent: Test Message Body with counter = 7 JMS Message Sent: Test Message Body with counter = 8 JMS Message Sent: Test Message Body with counter = 9 [delete] Deleting directory /PATH/TO/WebLogic_JMS_Bridge/tmp BUILD SUCCESSFUL Total time: 4 seconds
Step-12). Now login to WildFly 8.2 console and then check the JMS Queue “TestQ” runtime stats whether those messages reached to it or not.
http://localhost:9990/console/App.html#jms-metrics
Reference
I am just pasting the WebLogic side JMS Bridge configuration XML snippet here from “config.xml”
<messaging-bridge> <name>WLS12c_to_WildFly8_Bridge</name> <target>myserver</target> <source-destination>WLS_Source_Bridge</source-destination> <target-destination>WildFly_Destination_Bridge</target-destination> <selector></selector> <quality-of-service>Atmost-once</quality-of-service> <started>true</started> </messaging-bridge> . . . <jms-server> <name>My_JMSServer</name> <target>myserver</target> <persistent-store xsi:nil="true"></persistent-store> </jms-server> <jms-bridge-destination> <name>WLS_Source_Bridge</name> <adapter-jndi-name>eis.jms.WLSConnectionFactoryJNDINoTX</adapter-jndi-name> <user-name>weblogic</user-name> <user-password-encrypted>{AES}MZthQtsuT4GH55R5es9TQFUOU8dK8tvLy5xJl5DcN1E=</user-password-encrypted> <connection-factory-jndi-name>My_CF</connection-factory-jndi-name> <connection-url>t3://localhost:7001</connection-url> <destination-jndi-name>My_Q</destination-jndi-name> </jms-bridge-destination> <jms-bridge-destination> <name>WildFly_Destination_Bridge</name> <adapter-jndi-name>eis.jms.WLSConnectionFactoryJNDINoTX</adapter-jndi-name> <user-name>jmsuser</user-name> <user-password-encrypted>{AES}0hlGNKwgZkSw+YxjxJSAbkPJm0EnV5tn5Czd5CLTJgk=</user-password-encrypted> <connection-factory-jndi-name>jms/RemoteConnectionFactory</connection-factory-jndi-name> <initial-context-factory>org.jboss.naming.remote.client.InitialContextFactory</initial-context-factory> <connection-url>http-remoting://localhost:8080</connection-url> <destination-jndi-name>jms/queue/TestQ</destination-jndi-name> </jms-bridge-destination> <jms-system-resource> <name>My_SystemModule</name> <target>myserver</target> <sub-deployment> <name>Sub_My_Queue</name> <target>My_JMSServer</target> </sub-deployment> <descriptor-file-name>jms/my_systemmodule-jms.xml</descriptor-file-name> </jms-system-resource>
Source Code: All the relative contents can be found in the following link:
https://github.com/jaysensharma/MiddlewareMagicDemos/tree/master/WebLogic/JMS/WebLogic_JMS_Bridge
Regards
Jay SenSharma