MRTG Summary cgi 1.2
====================

About
-----
mrtgsum.cgi is CGI script written in Perl, which serve summary graphs from MRTG
RRDTool database files. It can generate page, which looks like from 14all.cgi.
Other option is to have graphs with layers, where one AREA is one TARGET and
input traffic is on the upper side and output traffic is negative.

Requirements
------------
- Functional MRTG with RRDTool and 14all.cgi
- PERL language
- HTTP server with CGI support or modperl

Installation
------------
- Modify mrtgsum.cgi for datapath (where your .rrd files are placed).
- Modify mrtgsum.cgi for RRDTool perl libraries, if required.
- Copy mrtgsum.cgi to cgi-bin path.
- Copy and edit mrtg.css if required.
- Create your own html page with links to cgi, or test it manually.

Using
-----
- Create HTML page with links to cgi with your own parameters.
- You can call it manually by entering right URI.

Parameters:
- "name" is name of your graph without spaces or special characters.
- "log" is parameter with target names separated by space. Target names are
names of rrd files without suffix .rrd similar to 14all.cgi syntax.
- "type" is type of graph. Default is "normal" similar to 14all.cgi.
Type "neg" is negative graph with layers visible.

Example:
http://mrtg.domain.tld/mrtg-cgi/mrtgsum.cgi?name=peering_total&log=router1_ge-0_3_0%20router2_ge-7_2_0%20router3_ge-0_1_0&type=neg

Features
--------
- Summaries are from final RRDTool data files
- XHTML 1.0 Strict valid
- On the fly generating
- There are 8 colors for layers. When you have more targets, colors are
cycled. Negative colors are very similar to positive colors, but a little
darker.
- Perl code use strict, warnings and taint options.
- Maximal rate is created from independent max speeds of rrd files.
- There are links to independent targets.
- mrtgsum.cgi generates xhtml page or png files in dependency, how it is called, like 14all.cgi.

Drawbacks
---------
- Other units are not supported.
- Links to independent targets are limited to identical hostname in cfg and log
parameters of 14all.cgi
- Spaces in url are not perfect, but I don't know, which other character is best.
- Names must not use spaces or special characters.

Authors
-------
mrtgsum.cgi is created by Pavel Ruzicka
http://www.pavouk.org/sw/mrtgsum/

Very thanks to Tobias Oetiker author of MRTG and RRDTool
MRTG http://people.ee.ethz.ch/~oetiker/webtools/mrtg/
RRDTool http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/

Thanks to Rainer Bawidamann for creating 14all.cgi
http://my14all.sourceforge.net/

EOF