#Triple D Consulting 
#Network Attached Device Diagnostic System 
#README File

Agent Name: CPU Load Agent
Agent Version: Version 2.1 
Agent Author: Daryl Quenet
Agent Date: 2003-May-28
Agent Purpose: 
	Agent detects the load of a single CPU Linux system. Or a 
multiple procesor Unix system.

Agent Installation Instructions:
	Place agent in the agents directory within the $BCNUHOME
	directory.  Add into $BCNUHOME/etc/agents parameters
	specified below.  
Agent Operating Dependancies:
	Linux & Solaris
Agent Security Dependancies:
	None
Agent Application Dependancies:
	awk, bc, grep,iostat (sysstat), sed
Additional Notes:
	-There are currently two different versions of the agent (see 
	 future additions).
	-This agent runs for a prolonged amount of time, the longer 
	 sample the more accurate a reading will be given.  Typically I 
	 run the agent 5 minutes which consists of a 4 (15 second 
	 intervals, 16 intervals) minute sample. 
	-The agent actually runs iostat or mpstat for one additional 
	 interval to take into account that iostat / mpstat bases the 
 	 first value on the overage total since bootup (so we throw it 
	 away). 

Tested by: N/A
Date Tested: N/A

Agent Syntax: Uses standard BCNU cron scheduler.
Agent call example:
    	agent:cpuload:::::$p1=$p2=$p3=$p4:
    	agent:cpuload:0-24:5:1:enabled:15=16=80=95: iostat >= 4.1.1
    	agent:cpuload.legacy:0-24:5:1:enabled:15=16=80=95: iostat <= 4.07
Parameters: $p1 is the interval, $p2 is the count, $p3 is sustained cpu 
usuage warning level, $p4 is the sustained cpu usuage error level.

Error condtions: File permissions change
Expected response: Sends error.
Actual response: Which CPU(s) are over the error range.

Warn conditions: Average CPU ususage over the warning level but under 
	the error level.
Expected response: Sends error.
Actual response: Which CPU(s) are within the warning range.

Successful conditions: Average CPU usuage under the warning level.
Expected response: Reports Ok!

Features To Add:
	-Single agent support for systems running both sysstat versions 
         before and after 4.1.1
	-To be merged with the SMP agent.
	-Support for both Linux And Solaris