# $Id: INSTALL,v 1.3 2004/03/11 20:22:47 petef Exp $

To install this sampler:

0) Make sure the switch RRD spool is setup in peg's /var/peg/switch.

1) Make sure perl is 5.6.0 or better.
   In the dmz a host need /opt/perl rsync'd or MTPd to it to
   run this stuff.

2) Make sure these CPAN modules are installed in perl's library,
   in order:
	Crypt-DES-2.03.tar.gz
	Digest-MD5-2.12.tar.gz
	Net-SNMP-4.0.2.tar.gz
   There is a cached copy of each in ../pollswitch

   In each directory you'll have to use:
	/opt/perl/bin/perl Makefile.PL && make && make test && make install
   to install these on a Solaris DMZ host.

3) Updated cisco.cf to include any new switches or sample hosts:
	$ rcsdiff cicso.cf ...
	..
	$ vi cicso.cf
 -->	$ make sanity
	...
	$ ci -u cicso.cf
   Note the extra "make sanity" step to be sure you have real hosts in
   the list.

4) Make install on all the new hosts, and any hosts that might be
   fail-overs for them.   Or you can do them all with:
	# M=`make msrc_list`
	# smsrc -m$M install

5) Login to each, su to monitor and run a sample poll, use the short hostname
   for "%%" below
	# su - monitor
	monitor$  mk -smPri -d%% /usr/local/lib/cisco.cf
	monitor$  sleep 2
	monitor$  mk -smAlt -d%% /usr/local/lib/cisco.cf

6) Pick windows to sample the pairs (0,2; 1,3; 2,4; 0,3; or 1,4)
   Still on that host, use crontab to add the 2 apropos lines from:
	0,5,10,15,20,25,30,35,40,45,50,55 * * * *
	1,6,11,16,21,26,31,36,41,46,51,56 * * * *
	2,7,12,17,22,27,32,37,42,47,52,57 * * * *
	3,8,13,18,23,28,33,38,43,48,53,58 * * * *
	4,9,14,19,24,29,34,39,44,49,54,59 * * * *
   if you are on a host w/o the option to set a PATH add
	. /usr/local/lib/distrib/local.defs &&
   then cap them with (replacing the %% with out host's tag-name):
	mk -smPri -d%% /usr/local/lib/cisco.cf 2>>$HOME/cisco.errs
	mk -smAlt -d%% /usr/local/lib/cisco.cf 2>>$HOME/cisco.errs
   On the Alternate host you must add the same two lines, and use
   that host's short hostname in the %% line.

7) Wait about 20 minutes, then look for:
	+ data on the PEG grahpic,
		http view
	+ each port with data is labled in the interface lists,
		/var/peg/lib/*.cl
	+ each host has the link to the switch for each interface,
		/var/peg/lib/Makefile [make links]

8) make sure you've checked in all your work.  You are done.

--
ksb, Dec 2003