ifGraph 0.3.5 - 15/01/2002 - Ricardo Sartori <sartori@duosite.com.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.5:
=========================================

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
System Description: Linux host.something.net 2.4.13 #4 SMP Mon Nov 5 16:03:28 BRST 2001 i586
System Uptime: 1 day, 01:12:14.46
| 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. Take note of the "if #" field
in the find-if.pl output.

3 - Edit your ifgraph.conf file. You must set the rrdtool, rrddir and graphdir
directives to something that match 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 use the options added to the 0.3.4 version of ifgraph, you may use the
following line to hel you:

	host.something.net:public:161:2:100M:Second Interface eth1:options

   The following options may be used in the configuration of the interface:
   (they MUST be separated by commas)
   h=N - graphic height (not the image height)
   w=N - graphic weight (not the image weight)
   in=#RRGGBB - the color (in hexa) that will be used in the area representing IN data
   out=#RRGGBB - the color (in hexa) that will be used in the line representint OUT data
   bg=#RRGGBB - the image background color (not graphic bg)
   canvas=#RRGGBB - the graphic background color
   font=#RRGGBB - the color that will be used in the image fonts
   invert - this option make OUT data to be ploted as IN data and vice-versa
   noerror - this options tells the program to not print any info about interface errors
   rigid - this holds the Y axis max at the bandwidth value
     
In a general way, the following line may be used to configure an interface in ifgraph:

hostname : community : agent port : interface number : bandwidth : description [: options ]

 Ex.:
 202.202.202.202:public:161:1:10M:Lan Interface:h=200,w=400,noerror,in=#333333
 203.203.203.203:private:161:3:128k:Wan Interface:invert
 150.150.150.150:somecommunity:161:1:100M:Ethernet Interface

4 - After the configuration, you may now run ifGraph. The program must be run each
5 minutes, so, it may be easier if you add it to your crontab. Just issue the command:

host$ crontab -e	

And add the following line:

*/5 * * * * /path/to/ifgraph/ifgraph.pl -c /path/to/ifgraph.conf ; /path/to/ifgraph/makegraph.pl -c /path/to/ifgraph.conf > /dev/null
(You must change the path to the ifgraph.pl, makegraph.pl and to your config file)
