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


Chapter 4 Configuring ActiveMatrix Host and Services Microagents

Chapter 4
Overview
This 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.
Configuration Prerequisites
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.
Configuration Instructions
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:/amx301ga
For example, c:/hawk49ga
For example, c:/amx301ga/data
For example, c:/hk49data/tibco/cfgmgmt/hawk
For example, tct.instance.install.dir=CONFIG_HOME/tct/admin/2010-09-16-13-06-04/scripts
If you are working on a standalone host, please use the following configuration:
tct.instance.install.dir=CONFIG_HOME/tct/tibcohost/2010-09-16-13-06-04/scripts
For 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.
For example, hawk.property.file=HAWK_CONFIG/data/Hawk-amx_variables.properties
3.
Windows: .\autoconfigure.bat
UNIX: ./autoconfigure.sh
4.
Edit the HAWK_CONFIG/bin/hawkagent.cfg to configure the following properties
a.
hma_plugin_dir "HAWK_CONFIG/plugin"
b.
variables "HAWK_CONFIG/data/Hawk-amx_variables.properties"
c.
auto_config_dir "HAWK_CONFIG/autoconfig"
Launch the tibhawkconfig.exe to add or modify these properties.
Under the "Agent" Tab:
a.
b.
c.
Set the variables file as HAWK_CONFIG/data/Hawk-amx_variables.properties
Start HawkAgent, Hawk HMA, Hawk Display and so on, as appropriate for your platform.
Managing and Monitoring Multiple TIBCO Host Instances in the same Hawk Agent
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 folder
 
Monitoring Application
In 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.
The application must be deployed separately to each Environment with nodes to be monitored.
Log into the TIBCO ActiveMatrix Administrator.
1.
2.
This will open the New Application wizard.
3.
4.
Leave the application template source as "An existing application template".
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.
9.
10.
Verify through the ActiveMatrix Services Microagent getConfig method. The Monitoring Application State should be "RUNNING".

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