Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Overview : TIBCO Hawk Plug-in

TIBCO Hawk Plug-in
TIBCO Hawk plug-in is a type of Hawk micro agent that resides with the process space of a Hawk Agent. Such Hawk plug-ins are used to communicate with a host of third party applications using their specific protocols and allow them to be monitored and managed within the Hawk subsystem.
TIBCO Hawk installation provides the following fully functional ready-to-use plug-ins:
However, one can always write a custom Hawk plug-in to suit specific needs, using the set of available Hawk API methods.
Writing a Custom Hawk Plug-in And Registering it With The Existing Hawk Agent
Hawk is an extensible product and additional monitoring capabilities can be added by creating plug-ins to it. Every plug-in requires a .hma file, which is a HMA configuration file, and a .jar file, which is a Java implementation of various methods you want to expose via the Hawk subsystem. Follow the below steps to create a plug-in:
1.
Create the .hma file.
Refer to the HAWK_HOME/examples/ma_plugin/DM*.hma file for guidance.
Most important constituent of this .hma file is the main/startup class of the plug-in implementation. That is to be mentioned under the <classname> tag. For example:
<classname>com.A.B.myPluginControllerClass</classname>
<arguments><arg>-traceDir</arg><arg>C:/LogDir</arg></arguments>
Absolute path of the implementation .jar files and all the required third party libraries should be mentioned under <classpath> tag. For example:
<classpath><path>C:/TPCL/libs/slf4j-api-1.6.4.jar</path></classpath>
2.
Place the .hma file into the folder CONFIG_FOLDER/plugin.
If you have more than one Hawk plug-ins, please make sure that all .hma files are present in the CONFIG_FOLDER/plugin subfolder.
3.
Edit the CONFIG_FOLDER/bin/hawkagent.cfg to set or uncomment the following parameter:
-hma_plugin_dir ${CONFIG_FOLDER}/plugin.
4.
Ensure that you have created the implementation .jar file in the same folder that is specified in the <classpath> tag within the .hma file.
Refer to the HAWK_HOME/examples/ma_plugin/DM*.java for guidance.
5.
You should now be able to view your custom plug-in microagent and corresponding methods in Hawk Console.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved