ifGraph 0.3.1 - 09/06/2001 - Ricardo Sartori <sartori@lrv.ufsc.br>

Requirements:
 - Perl >= 5.0 (http://www.perl.org)
 - Net::SNMP Perl Modules (http://search.cpan.org/search?dist=Net-SNMP)
 - RRDTool >= 1.3.32 (http://ee-staff.ethz.ch/~oetiker/webtools/rrdtool/)

Quick steps to start using ifGraph 0.3.1:
=========================================

1 - Search for the interfaces you want to monitor with the find-if.pl
script. Let's say you want to monitor host host.something.net, but you dont
know wich interfaces to monitor, you may do something like this:

otherhost 35$ ./find-if.pl host.something.net somecommunity
OK: session created, getting info from host.something.net
Showing up interfaces of: host.something.net
Interface total: 5
OK: Collecting info on each interface, wait...
......
OK: Data collected
| if # | Description            | Stat | Octets In     | Errors  | Octets Out    | Errors |
-------------------------------------------------------------------------------------------
| (1)  | eth0                   | up   | 2421689163    | 278     | 3024455811    | 26     |
| (2)  | eth1                   | up   | 4046770442    | 14118   | 3653663255    | 1      |
| (4)  | lo0                    | up   | 1085194330    | 0       | 1085197143    | 0      |

2 - Decide wich interfaces you want to monitor.

3 - Edit your ifgraph.conf file. You must set the rrdtool, rrddir and graphdir
directives to something that matches your needs. Next, configure wich interfaces
you want to monitor. Imagine that you want to monitor interface 2 of the host
host.something.net. Your line would be something like this:

	host.something.net:public:161:2:100M:Second Interface eth1
     
If you want to monitor another interface, just create another line following this
sequence:

hostname : community : agent port : interface number : bandwidth : description

4 - After configuration, you must initialize your RRD databases. You must use
ifgraph.pl with the -i and -c flag. The -i flag tells the program to Initialize
the RRD database and -c tells the program to read the Configuration file specified.

galia 44$ ./ifgraph.pl -i -c ./ifgraph.conf
File /home/user/rrdfiles/host.something.net.if2.rrd will now be created

The name of the file is given based on the host name and on the interface number.
	
5 - Now your databases are created, you must add the following line to your crontab:
    (Change the paths to the programs and to the ifgraph.conf file)

*/5 * * * * /path/to/ifgraph/ifgraph.pl -c /path/to/ifgraph.conf ; /path/to/ifgraph/makegraph.pl -c /path/to/ifgraph.conf > /dev/null



===================
Ricardo Sartori
Virtua FLN - IDC
sartori@lrv.ufsc.br
===================
