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


Chapter 3 Java Virtual Machine Plug-in Microagent : Installation and Configuration

Installation and Configuration
TIBCO Hawk Java Virtual Machine Plug-in microagent enables TIBCO Hawk to monitor Java virtual machine processes started by the same user on the local machine.
To configure this plug-in into your TIBCO Hawk installation:
1.
Copy the hawkvm.hma file from HAWK_HOME/plugin/jvm to CONFIG_FOLDER/plugin.
2.
Edit and verify hawkvm.hma in CONFIG_FOLDER/plugin to correct version and path of jars and Trace Log Configuration.
<!--Trace Configuration -->
<arg>--traceDir</arg> <arg>%TIBCO_HAWK_HOME_ESC%/plugin/jvm/log</arg>
<arg>--traceFilename</arg>
<arg>jvmhma.log</arg>
<!-- Trace Level -->
<!-- ALL = -1, ALWAYS=0, INFO=1, WARNING=2, ERROR=4 DEBUG=8 -->
<!-- Default is INFO + WARNING + ERROR -->
<arg>--traceLevel</arg>
<arg>7</arg>
3.
Edit CONFIG_FOLDER/bin/tibhawkagent.tra to add <JAVA_HOME_ESC>/lib/tools.jar in tibco.class.path.extended, if using external JRE and not already added.
4.
Edit hawkvm.hma to ensure correct path for tools.jar - most preferably from HAWK_HOME/tibcojre{64}/1.8.0/lib in the classpath section.
5.
Make sure the -hma_plugin_dir property is uncommented and have a value "HAWK_HOME/plugin" in CONFIG_FOLDER/bin/hawkagent.cfg.
6.
Make sure the "application.args -file hawkagent.cfg" is not commented in the CONFIG_FOLDER/bin/tibhawkagent.tra file.
7.
On Windows Platform: Ensure that attach.dll is present in the jre\bin folder. The JRE could be the one supplied by TIBCO installer (v1.8 if chosen during the installation), or any of the JRE v1.8.x you may have previously installed. This library is not part of pure JRE v1.8.x distribution bundle from ORACLE, although it was part of JRE v1.6.x distribution bundle from ORACLE/Sun. This library however is required for HAWK JVM plugin operation. It is present as part of jdk\jre distribution. You may also get it from ORACLE download site.
On UNIX Platform(s): Ensure that libattach.so is present in jre\lib folder. It is present in JDK distribution under jdk/jre. The JRE could be the one supplied by TIBCO installer (v1.8 if chosen during the installation), or any of the JRE v1.8.x you may have previously installed. This library is not part of pure JRE v1.8.x distribution bundle from ORACLE, although it was part of JRE v1.6.x distribution bundle from ORACLE/Sun. This library however is required for HAWK JVM plugin operation. It is present as part of jdk\jre distribution. You may also get it from ORACLE download site.
 

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