![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
Chapter 4 Configuring ActiveMatrix Host and Services MicroagentsThis chapter covers optional configuration of two microagents and the monitoring application provided with this product, that together provide the monitoring and management of ActiveMatrix hosts, nodes, components, and services via TIBCO Hawk.The rulebases and scripts provided in this sample demonstrate the use of the ActiveMatrix Host microagent (introduced in TIBCO Hawk 4.9), to monitor and manage ActiveMatrix 3.x hosts and nodes. For more details on rules refer to, Appendix A, Configuring TIBCO ActiveMatrix 3.x Hawk Rulebase Samples.These two microagents and the monitoring application may be installed into one or two TIBCO_HOME environments.The two microagents are installed with TIBCO Hawk on every machine where ActiveMatrix nodes and hosts are running. The configuration step allows these microagents to monitor multiple nodes and even multiple hosts on each machine.The monitoring application is installed onto the machines that run the ActiveMatrix System or Administration node. The configuration step deploys the application to all nodes through the ActiveMatrix Administrator web interface.Before configuring ActiveMatrix Host Microagent & ActiveMatrix Service Microagent on Windows Platform, please make sure that PowerShell is installed on the machine.Use the following steps to get the ActiveMatrix 3.x sample rulebases configured for use with TIBCO Hawk 4.9.If you have installed the product across multiple TIBCO_HOMEs, use the location where the TIBCO Hawk Agents were installed (with TIBCO Hawk).
1. Go to HKAM_ROOT/samples/rulebases directory.
2. Edit the autoconfigure-amx-hrb.properties to specify the following variables:For example, c:/amx301gaFor example, c:/hawk49gaFor example, c:/amx301ga/data
− hawk.config.mgmt.home - config home for TIBCO Hawk 4.9 (different from AMX 3.x config home)For example, c:/hk49data/tibco/cfgmgmt/hawk
− tct.instance.install.dir - the TCT Admin Server configuration run to be used to configure the ActiveMatrix propertiesFor example, amx.hpa.is.secure=false
− hawk.property.file - the output property files which will be used in hawkagent.cfg (as external variables). Note that you don't have to edit this property if you want to keep the default value.Windows: .\autoconfigure.batUNIX: ./autoconfigure.sh
• Edit the HAWK_CONFIG/bin/hawkagent.cfg to configure the following properties
a.
b.
c. Launch the tibhawkconfig.exe to add or modify these properties.
a. Set the Autoconfiguration Directory as HAWK_CONFIG/autoconfig
b.
c. In order to generate rulebases and microagent configurations for multiple TIBCO Host instances on the same machine, and manage these via the same Hawk agent, you need to repeat setup Steps 1 and 2 for each TIBCO Host instance you need to configure.This will update the existing TIBCO Hawk Variables file and merging properties for each instance into the same file.Separate configuration properties and rulebases will be either created or merged in following folders for each TIBCO Host instance.
a. Configuration Properties - HAWK_CONFIG/data/Hawk-amx_variables.properties folder
b. Rulebases - HAWK_CONFIG/autoconfig folderIn order to collect service operation statistics on each node, the ActiveMatrix Service microagent requires the deployment of an ActiveMatrix 3.x Monitoring Application to each node that the microagent is monitoring.
2. Select New.
5. Select Next to move to the template selection screen.
6.
7. Select Next to move to the Summary screen.
8. Select Save and Exit to close the wizard.Verify through the ActiveMatrix Services Microagent getConfig method. The Monitoring Application State should be "RUNNING".
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |