Procedure for Configuring TIBCO Hawk for EMS
JMS MicroAgent Configuration
Monitoring of Queues/Topics require configuring of the EMS plugin.
TIBCO Hawk Plugin for EMS
Procedure for configuring TIBCO Hawk for EMS:
a) Locate the tibjmsadmin.hma file in the TIBCO Enterprise Message Service installation directory. Go to TIBCO_HOME\EMS\<EMS_VERSION>\samples\admin\hawk.
b) Copy and paste the .hma file into TIBCO_HOME\hawk\<HAWK_VERSION>\admin-plugins.
c) Locate the following files below in TIBCO_HOME\EMS\<EMS_VERSION>\lib.
d) Copy the .jar files in TIBCO_HOME\hawk\<HAWK_VERSION>\admin-plugins.
e) Navigate to plugins directory and open the tibjmsadmin.hma file in a text editor.
f) Specify the TIBCO Hawk microagent class you wish to use in the <classname> element. You can use either the HawkListener class if you only want to monitor the server, or you can specify the HawkController class if you want to monitor and manage the server.
Note: In the image above, HawkListener is specified in <classname>.
g) Specify the username and password and server URL used to connect to the TIBCO Enterprise Message Service server in the appropriate <arg> elements.
h) You should specify the predefined admin user or a user that is a member of the $admin group.
i) Go to All Programs->TIBCO-> TIBCO_HOME->TIBCO HAWK<Version>->Hawk Configuration. Right Click and run as administrator.
j) TIBCO Hawk Configuration Utility window starts up.
k) Go to Agent tab. Click Browse at Plugins field. Refer to Microagent Plugins section in Agent tab.
l) Browse for the admin-plugin directory. The location of .hma and .jar files copied from EMS location.
m) Click on OK. A window pop up for restarting the TIBCO Hawk Agent Windows Service restart. Click on Yes.
n) Go to Services.msc. Restart TIBCO Hawk Agent service.
Note: Generally, there will be two hawk agents in services, when a TIBCO Hawk Software version is installed separately. The two hawk agents are as follows: the default one, which comes along with TRA installation and the separate version. Either one of them, which is being used for Hawk monitoring and display should be running. Stop the other.
o) Start the Hawk display. Refer to Section Getting started with Hawk Display.
p) Right Click the Host Machine name. Click on Get MicroAgents.
q) The JMS monitor Microagent will get added to the existing list of default Microagents with the list of methods.