Enable Monitoring Via TIBCO Hawk

See the appropriate instructions:

ActiveMatrix BusinessWorks Version 6

Perform these instructions if you are monitoring ActiveMatrix BusinessWorks version 6:

  1. Enable your applications for statistics collection. You can do this using the TIBCO BusinessWorks administrator CLI with commands such as:

    2. bwadmin enablestats -d MyDomain -a MyAppSpace process MyAppName MyAppVersion

    Repeat for each application you wish to monitor.

  2. Enable the Hawk MicroAgent in your AppNodes for each AppSpace you wish to monitor. Refer to the Enabling TIBCO Hawk MicroAgent section of the TIBCO BusinessWorks6 Administration Guide.

ActiveMatrix BusinessWorks Version 5

Perform these instructions if all you are monitoring ActiveMatrix BusinessWorks version 5:

  1. In the TIBCO Administrator, go to the Configuration page of your application.

  2. In the Configuration Builder panel, select the name of the application.

  3. Go to the Edit Application Configuration page.

  4. Select the Advanced tab.

  5. Find the global variable HawkEnabled and set its value to true.

  6. Save the configuration.

Install the RTViewBWAgent plug-in microagent

ActiveMatrix BusinessWorks Version 5 users, continue.

Note: This section does not apply if all your engines are deployed as BusinessWorks Service Engines (BWSE).

Install the RTViewBWAgent plug-in microagent in the Hawk Agent for each domain you have configured to communicate with the Monitor.

RTViewBWAgent detects deployed engines and gets their maximum heap size metrics when the Hawk agent is started. If RTViewBWAgent is not installed, deployed engines are not detected until they have been started and report data to the Monitor. When live data is received the engine is added and its Status is set to LIMITED. The Status remains LIMITED because, although live data metrics are available, the deployment and maximum heap size metrics are still unavailable.

Note: After installation, you can use the Hawk Display to view the RTViewBWAgent microagent and invoke its methods: GetBWDeploymentNames and GetBWDeploymentMaxHeapSizes.

You can also configure the agent to detect deployed engines and make data updates at more frequent, specified intervals. To specify the update interval you uncomment the -update argument in the BWAgentPlugin.hma file and specify a non-zero value. When the -update argument is not used (is commented out), the Monitor does not report that an engine has been deployed or undeployed until the Hawk agent is restarted.

  1. Navigate to the lib directory of your Monitor installation and locate the following two files:

  2. For a given domain, find the plug-in directory via this path:

    3. <TIBCO-home>/tra/domain/<domain-name>

  3. Repeat Step 2 for each Hawk domain you have configured to communicate with the Monitor.

  4. To (optionally) set RTViewBWAgent to make data updates at more frequent, specified intervals, open the BWAgentPlugin.hma file, uncomment the -update argument and specify a non-zero value. The value, which defaults to 300, represents the update interval in seconds. For example, a value of 3600 updates every hour:

    5. <arguments>    

    <arg>-update:3600</arg> 

    . .    

    </arguments>    

  5. Copy the BWAgentPlugin.jar file and BWAgentPlugin.hma file into the plug-in directory and restart the Hawk Agent.