#Triple D Consulting 
#Network Attached Device Diagnostic System 
#README File
Agent Name: tracert Agent
Agent Version: Version 1.4
Agent Author: Dustin Downs
Agent Date: 2003-May-5
Agent Purpose: 
	Agent preforms traceroute from host to designated locations (locations with static routing).

Agent How Does It work:
	Performs tracroute to locations in paramater list, cleans up output and records path. Agent
	archives route in a file for future comparing. On subsequent runs, the agent compares result
	to previous result and notes if there has been a change. Changed routes are archived for 
	further analysis. One error thrown when routes change.

NOTE:	If ANY of the routes change, bcnu will throw an error warning to the summary page.
	However, each routing table is evaluated independantly and will be listed in the detailed
	report. ALL routes must remain unchanged to send an OK status message.
	
Agent History:
	First revision basic script testing traceroute and sed routines. Second revision added 
	archiving and datestamp. Third revision added history output. Fourth revision removed 
	history, added more verbose description of backup location and filename.

Agent Installation Instructions:
	Place agent in the agent directory within the $BCNUHOME
	directory.  Add into $BCNUHOME/etc/agents file.
	Usual calling syntax. 
	
Agent call example:
     	contrib:tracert:0-24:15:8:enabled:domain or ip:
eg.	agent:tracert:0-24:2:5:enabled:www.yahoo.com:


Agent Operating Dependancies: 
	Linux (Tested on Redhat 7.3)
	Kernel used - 2.4.18-27.7.x
	
Agent Application Dependancies:
	BCNU v1.22
	AWK
	grep
	sed
	traceroute available
	
Features To Add:
	-warn on retried hops
	-error on excessive latency

-----------------TESTING--------------------------

Tested by: Dave Blizard
Date Tested: April 15, 2003
Testing platform: Redhat 7.3, traceroute-1.4a12-2, BCNU v1.22
Testing methodology: Force errors by: testing routes outside the controlled network into public
switched networks (route should change)
Forced error responded as expected.

Warn condtions: URL/ip not being monitored
Expected response: agent will report a warning. 
Actual response: as expected (had to del file during run to force error)
sample output:Warning - www.drmadcow.net is not being monitored

Error condtions: Route changes
Expected response: agent will report an error if any routes change from previous agent results
Actual response: as expected
sample output:
error - Routing for www.yahoo.com has changed, original route backed up

Successful conditions: ALL of the routes remain unchanged.
Expected response: Reports Ok!
Actual response: Works.
sample output:
ok - no routing has changed