Hermes Configuration

From SiggersWiki

Note: These instructions work with Hermes 1.9.2, which is not the most recent but works fine. Newer versions are configured in a similar way to the verison described here.

Note: The instructions here do not seem to work for ICAN JMS Topics - the stcjms.jar SeeBeyond implementation of topics does not seem to allow for JMS Topic browsing.

At first, I would delete the previous installation of hermes that you might have, then start fresh, as it's quite easy to mess the configuration up in such a way that it's difficult to recover from.

First, you have to define the Seebeyond JMS provider. To do this, go to Options->Configuration... from the main screen, and click on the provider tab at the bottom of the window. I have attached a screenshot below:

After you have added the Group and JAR file (you need to use stcjms.jar, which you can probably find somewhere on your logical host) you're sent. Press ok to save the changes - it might ask you if you want to scan the JAR - say yes.

Then go to the 'sessions' window section on the right side of the main screen, under the 'jms' tree root there is a 'sessions' item - right-click on this entry, and say pick 'new' session.

I have attached a finished session screen shot - how you do it is a little weird. Do not touch anything except the 'Connection Factory' definitions - don't touch plugins or anything like this.

First you have to pick the 'Loader' under connection factory - choose the entry you created in the previous step. Then, in the 'Class' list beside the loader entry, you should see the SeeBeyond connection factories. You need to pick one of the *STCQueue or *STCTopic factories respectively depending if you want to work with queues or topics - if you pick the topic one and try to look at a queue, it won't work.

Then there is a grid below these two entries under the Loader and Class selections - right click on the empty space, and say 'add property'. Then you can pick what property you'd like to set - you need to set 'host' and 'port', which are the hostname and queue name of your ICAN JMS Queue manager. Everything else you don't need to set, except maybe the name of the Session (instead of <new>)

After you've clicked 'Ok', you should have your session set up on the right hand side of the menu. Then you can right-click on the session and add queues - it's pretty easy, have attached a screenshot. Then you are all ready to go.

One important note - make sure you get the queue name right. If you get the queue name wrong, the JMS provider will make a new queue with the name you typed in, which can be not what you are expecting.

--Ben 23:36, 3 January 2006 (CET)