HQU Platform Alert Manager

Plugin: Platform Alert Manager
Author: Jeff Schwartz
Version: 0.2
Works With: HQ 3.2.2 or greater
File: platalertman0_2.tgz

Description

Enable and disable alerts per platform via the command-line or scheduled control action.

Installation

Installation of an HQU plugin involves moving the plugin directory into HQ's deployment.

tar -xzvf platalertman0_2.tgz
mv platalertman <hq_server_home>/hq-engine/server/default/deploy/hq.ear/hq.war/hqu

Testing the Plugin

cd <hq_home>/hq-engine/server/default/deploy/hq.ear/hq.war/hqu/platalertman/bin
java HypericPlatformAlertManager hyperic-url username password [enable|disable] platform-name

For Example:

java HypericPlatformAlertManager http://localhost:7080 hqadmin hqadmin disable myplatform

if it worked, you will get "result=OK"

Please note, that the platform name is the name according to Hyperic HQ's inventory

Scheduling Downtime

1. Copy the platalertman/bin directory to a platform that you would like to schedule for downtime.
2. Modify the enable.sh and disable.sh scripts to match the platform name
3. In the HQ UI, navigate to the platform and click the "Tools Menu" - "New Platform Service"
4. Name your service something like "Disable Alerts <platform-name>"
5. Choose a "Service Type" of "FileServer File"
6. Click "Configuration Properties"
7. In the "Path" field, put the fully qualified path to the disable.sh script from step 2
8. Click the "Control" tab
9. In the "Quick Control" section, change the "Control Action" to "run"
10. Click the play button
11. Verify the result in the "Command Status" field at the top of the page
12. Schedule your down time by clicking the "New" button in the "Control Action Schedule" section
13. Select "Run" from the "Control Action" menu
14. In the "Schedule" section, you can schedule your events to run daily, weekly or monthly.

There is a pretty big JavaScript bug that prevents you from selecting the current month. To get around this, select "12 (Dec)" from the month drop down. In fact, all months are going to be one high because of this bug. Also, this bug will change the date if you want to modify the schedule. To summarize, be very careful when scheduling your downtime.

Repeat steps 3-14 to setup the "Enable Alerts <platform-name>". You now have a scheduled window of downtime that you can repeat daily, weekly or monthly.

The Platform Alert Manager plugin would benefit from a few more features. The future enhancement list includes:

• Custom plugin that integrates the control function by passing in the current platform.
• Auto add the "Platform Downtime Schedule" plugin to the inventory

Track progress of this plugin here:

http://blogs.citytechinc.com/jschwartz/?p=10