# $Id: README,v 1.6 2011/02/02 17:46:30 mawalsh Exp $
# see http://tools.cisco.com/Support/SNMP/do/BrowseOID.do?local=en&translate=Translate&objectInput=1.3.6.1.2.1.2.2.1.10

This program scrapes data from Cisco IOS based switches to send to
PEG as UDP based RRD updates for port counters.

It is largely stolen bits from snmpwalk, Cricket, and other programs
we've seen (or coded).  By adding more cases to it, and some logic
for snmp v1 devices, we hope to deal with every Cisco device we have
at FedEx (at least).

Gear without proper forward DNS gets an entry in taco.fedex.com, so
we depend on that being in resolv.conf (on any host which polls such
devices).

Theory of operation.  We poll a device from two host (called the
PRImary and ALTernate hosts) every 4 to 6 minutes.  These hosts
are staggered in their polls (see PEG's sample docs) so that when
one host is off-line, or fails to sample, the other hits most of
the 5 minute RRD sample buckets.  The two hosts that sample any
cisco device are listed in "cisco.cf" and POLLPRI and POLLALT.

The mk rules for primary (-mPollPri -d$sample_host)  and alternate
(-mPollAlt -d$sample_host) are fired up from monitor's crontab to
make it all go.

N.B. there is substantial pixie dust in the mk rules in cicso.cf; these
are wired into the Makefile, monitor's crontab, and some shell scripts
in /opt/peg (maybe).

For example to get the list of target hosts we should push to:
	M=`make msrc_list`
	smsrc -m$M install

--
ksb, petef, csg