• WLS
    February 18, 2009

Hermes JMS – Revisited for WebLogic Server JMS 10gR3

Guest Author

Hermes JMS is an open source JMS Browser created by Colin Crist and hosted on Sourgeforge that works with numerous JMS implementations including WebLogic JMS and Oracle Application Server JMS.  I have written about using Hermes and WebLogic together before so see that entry for an overview.  I have found that this tool works great for me to quickly view/move/delete JMS messages in queues and topics.  This entry is simply an update for the recent version of Hermes 1.13 and WebLogic Server 10gR3.  Here’s a screenshot that highlights just some of the capabilities, click to enlarge.


  • I like using the off-line installation from Sourceforge for reasons that will probably become apparent below, but there is also a Web Start version on the project home page.
  • I found an old comment that I had written that claimed using the same JVM as the WLS server with Hermes helps, so I modify the %HERMES_INSTALL%\bin\hermes.bat file to use JRockit from WLS 10gR3:
SET JAVA_HOME=C:\Oracle\wls10gR3\jrockit_160_05
set PATH=C:\Oracle\wls10gR3\jrockit_160_05\bin

  • Launch Hermes and go to Options->Preferences to add the weblogic.jar to the providers tab, this is nice because presumably I could use multiple WLS versions (I haven’t tried that)


  • Configure a new Session in the GUI.


  • Then right click on the session and select “Discover” and you should have all the destinations available to browse.
  • The Session gets saved in hermes-config.xml (C:\.hermes\hermes-config.xml on my machine) and the relevant snippet looks like this:
        <factory classpathId="weblogic10.3">
            <provider className="hermes.JNDIConnectionFactory">
                    <property name="initialContextFactory" value="weblogic.jndi.WLInitialContextFactory"/>
                    <property name="providerURL" value="t3://localhost:7001"/>
                    <property name="securityCredentials" value="weblogic"/>
                    <property name="binding" value="javax/jms/QueueConnectionFactory"/>
                    <property name="securityPrincipal" value="weblogic"/>
            <connection clientID="" connectionPerThread="false">
                <session audit="false" id="examplesQCF" reconnects="0" transacted="true" useConsumerForQueueBrowse="false"/>
            <destination domain="1" name="weblogic/wsee/DefaultQueue"/>
            <destination domain="1" name="weblogic/examples/ejb30/ExampleQueue"/>
            <destination domain="2" name="weblogic/examples/jms/exampleTopic"/>
            <destination domain="1" name="weblogic/examples/jms/exampleQueue"/>
            <destination domain="1" name="jms/MULTIDATASOURCE_MDB_QUEUE"/>
            <destination domain="2" name="quotes"/>
            <destination domain="2" name="stockTopic"/>
            <extension className="hermes.ext.weblogic.WebLogicJMSAdminFactory">

    Now you should be ready to browse.  You could also take the alternative route of binding to the Initial Context of the server, which then makes it easy to create multiple Sessions from the Connection Factory objects.  However, I had trouble doing this without editing the hermes-config.xml due to what might be a fluke in the GUI for changing the class-loader provider from System to the WebLogic10.3 one that has the weblogic.jar.  If you have trouble with this you can either edit the hermes-config.xml file to have the correct provider or just add the weblogic.jar to the classpath (so System inherits it).  Good luck with Hermes.

    Join the discussion

    Comments ( 17 )
    • ANAND Monday, December 21, 2009
      From where i can download Hermes JMS and also can we view or delete Jms messages if the user is monitor other than Admin.
    • james.bayer Friday, December 25, 2009
      You can get Hermes JMS here:
      I have never tried manipulating messages as anything other than an Admin role, you might ask in the WLS JMS OTN forum what user permissions are required.
    • aylin Friday, January 22, 2010
      Nice post, thanks!
      Can i see content of 'consumed' messages with Hermes?Because i am hitting some problems in weblogic jms and i can not be sure that if a message arrived my queue or not.Ofcourse checking message count is a way but is not enough for me. I need to see content of the message consumed.
    • james.bayer Friday, January 22, 2010
      No, once a message is consumed from a queue, Hermes has no knowledge of it because WebLogic does not keep any data about consumed message contents.
    • Seth Tuesday, January 26, 2010
      Have you tried connecting to Oracle Application Server and the Topics used by ESB in HA?
    • james.bayer Tuesday, January 26, 2010
      No, I have not, but hermesjms.org has some config info for Oracle Application Server:
      Good luck, James
    • Tejo Pendyal Tuesday, August 3, 2010
      Nice post, can I use Hermes to connect a weblogic 10.2 on server from my laptop?
      It always gives me exception.
    • james.bayer Tuesday, August 3, 2010
      Just last week a customer told me that they were able to use the wlfullclient.jar to use Hermes with a remote WLS server. As of WLS 10.x, weblogic.jar should not be copied around because it has relative references. Either use reference the weblogic.jar at the location where it is installed or try to build a wlfullclient.jar and see if that works. Good luck, James
    • Leonard Tuesday, November 2, 2010
      I have configured as described and switch the Java_home, Path to JRocket. But Hermes still complains it can not find the class in weblogic.jar 10.3, see below
      va.lang.NoClassDefFoundError: weblogic/security/subject/AbstractSubject
      How to do now?
      Thank you
    • james.bayer Tuesday, November 2, 2010
      Did you add either weblogic.jar (in the location where WLS is installed, not copied) OR wlfullclient.jar to your provider tab?
      That is required.
      There is an old recording for 9.2 here:
      Good luck, James
    • keith Wednesday, January 12, 2011
      Hi James,
      Thanks for the article. We have successfully set up Hermes on weblogic 10.3.
      Just wondering if you've seen this strange behaviour. We've noticed that some messages do not appear using Hermes, but they are visible via the weblogic console.
      So far all messages we have found like this have a "state string" value of Ordered, while all other messages have a "state string" value of Visible.
      Any idea what the state string value corresponds to?
    • james.bayer Wednesday, January 12, 2011
      Are you using WebLogic Server JMS features like Unit or Order or Unit of Work? That would probably effect the visibility of messages to a standard client like Hermes.
    • John Monday, March 28, 2011
      James I have followed your steps and seem to get the following problem.
      Could not create InitialContext: failed to unmarshal class
      weblogic.security.acl.internal.AuthenticatedUser:nested exception is java.io.StreamCorruptedException invalid type Code : 31
      I am targeting weblogic 9.2
      My Hermes is 1.4
      Hermes is using JDK 1.6.11
      Any assistance towards this would help.
    • james.bayer Monday, March 28, 2011
      John, I recommend trying the same JVM that you're using on WLS to start Hermes. So in this case, that means going back to a 1.5 based JVM for the Hermes client. There may be a JVM option that helps with this, -Dsun.lang.ClassLoader.allowArraySyntax=true that could be used on the Hermes client with JVM 1.6. See the last comment on http://www.thatsjava.com/java-core-apis/39552/ for more details. Thanks, James
    • John Tuesday, March 29, 2011
      Hi James,
      Yes the class path property did do the trick.
      However I did not switch JVM's as I was trying to run Hermes from SOAP UI and that definitely wanted JDK 1.6.14 other wise the Swing UI does not start up for older versions of the JDK,I tried it with JDK 1.5.11.
      Thanks for the help and assistance.
    • guest Monday, May 16, 2011
      the info you provide here effectively means that hermes cannot be used with jdks older than 1.6 that is a serious limmitation i figure? (due to serialization issues)
    • james.bayer Monday, May 16, 2011
      Guest, I think the easiest path is to use Hermes with the same JDK that you are using with WebLogic Server (unless you're using WLS 8.1 since I don't think Hermes supports 1.4.2 JVMs). You may be able to get it to work with a 1.5 WLS JVM (such as WLS 9.2 and 10.0) and a 1.6 Hermes JVM, but I have not used it in that way. Good luck, James
    Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.