Universal Messaging integration with JNDI

Universal Messaging is the default messaging component used by webMethods Integration Server. Here is a short tutorial how you can test JMS processing using SoapUI and HermesJMS.

• SOAPUIDIR points to the installation directory of SoapUI, e.g. C:\Program Files\SmartBear\SoapUI-5.1.3.
• NIRVANADIR points to the installation directory of Nirvana, e.g. C:\SoftwareAG\nirvana.

Setup Universal Messaging

• First of all you need to create the needed artifacts in your Universal Messaging realm. Start with the JNDI Provider URL and click Apply.
• Then add a Connection Factory, Topic Connection Factory, and Topic: 

Setup Integration Server

• Create a JNDI Provider Alias for Universal Messaging under Settings > Messaging > JNDI Settings: 
• You can now test the alias and should see the artifacts you created in Universal Messaging: 
• Create a JMS Connection Alias for the JNDI Alias under Settings > Messaging > JMS Settings. Use the corresponding values from Universal Messaging for JNDI Provider Alias Name and Connection Factory Lookup Name: 
• Enable the Connection Alias: 

Setup SoapUI/HermesJMS

• Copy the following JARs to SOAPUIDIR\hermesJMS\lib: NIRVANADIR\lib\jndi.jar, NIRVANADIR\lib\nClient.jar, NIRVANADIR\lib\nJ2EE.jar, NIRVANADIR\lib\nJMS.jar.
• Create a new session named IS and add all above JARs to a new classpath group named IS: 
  Click Apply and restart HermesJMS.
• You should now be able to select IS under Loader and hermes.JNDIConnectionFactory under Class: 
  Add the properties host, port, initialContextFactory, providerURL, and bindingunder Connection Factory and configure them according to your environment. You can find the needed values in the JNDI settings of Universal Messaging: 
• You should now be able to discover queues and topics for the session: 
• To test the subscription to a topic, you can now browse the topic: 
• If you send a test message with Software AG Designer, you should see the message in HermesJMS: 
  

Possible errors

• hermes.HermesException: The binding property to locate the ConnectionFactory in the Context is not set: 
  Add the property binding under Connection Factory in the session preferences (right-click on the session and Edit).

Additional Links

http://um.terracotta.org/index.html#page/Universal_Messaging_Documentation_Set/to-overview-jndiadmin.html

http://techcommunity.softwareag.com/web/guest/pwiki/-/wiki/Main/Using+webMethods+Integration+Server+with+webMethods+Nirvana+Messaging

https://community.smartbear.com/t5/SoapUI-NG/subscribe-to-JMS-queue-on-Universal-Messaging-webmethods/td-p/95227

http://serviceorientedarchitect.com/how-to-test-jms-processing-in-webmethodsterracotta-universal-messaging-and-integration-server-with-soapui-and-hermesjms/