##############################################################################
#    The DataGrapher Project - Copyright (C) 2004 - 2006 by Lars Wildemann   #
#    Tool  : DataGrapher - Next Generation   Version 2.0                     #
#    Author: Lars Wildemann <datagrapher@larsux.de>                          #
#                                                                            #
#    This program is free software; you can redistribute it and/or modify    #
#    it under the terms of the GNU General Public License as published by    #
#    the Free Software Foundation; either version 2 of the License, or       #
#    (at your option) any later version.                                     #
#                                                                            #
#    This program is distributed in the hope that it will be useful,         #
#    but WITHOUT ANY WARRANTY; without even the implied warranty of          #
#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           #
#    GNU General Public License for more details.                            #
##############################################################################

OVERVIEW
	The DataGrapher consist of 2 main parts:
		- The API (dataGrapher-ng.cgi) runs in a Webserver environment such as Apache.
		- The Collector (dataCollector-ng.pl) is a standalone prozess, which is initiated by the CRON Deamon.

	The continuously collected data is stored in RRD Files (http://oss.oetiker.ch/rrdtool/).
	The maintenance data is stored in a MySQL Database.
	

REQUIRERMENTS
	- Perl    (check with `perl -M<MODULE> -e 'print "OK\n"'`)
		- CGI
		- Log::Log4perl
		- URI::Escape
		- Storable
		- Time::Local
		- DBI
		- Net::SNMP
		- RRDs
	- HTTP Server
	- RRD-Tool
		http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/download.en.html


INSTALLATION
	1)
		First, extract the Archiv into a Directory, from which the HTTP Server will process it.
		
	2)
		If dosn't exists, create the following Directories:
			<installDir>/data
			<installDir>/logs
			<installDir>/etc
			<installDir>/spool
	3)
		If needed, accommodate the File/Directory Permissions, so the HTTP Server will have no problems.
			<installDir>/logs   : HTTPServer (rwx)
			<installDir>/spool  : HTTPServer (rwx)
			<installDir>/cgi-bin: alle (x)
	
	4)
		Generate your own Configfile or copy it from the '/doc' Directory and modify it to your needs.
	
	5)
		Configure your Database and Webserver, for serving your new Tool. Examples for Apache are placed in '/doc'.

	6)
		Install the dataCollector. E.g.: crontab -e
			*/5 * * * *     /var/www/DataGrapher/tools/dataCollector-ng.pl 1>/dev/null


FINISH
	Easy, isn't it?!?

	For lazy people there is a binary (shell script + tar archive) which will do the most work for you!
	Look at 'http://sourceforge.net/projects/datagrapher/' for new Releases.

AUTHOR
	Lars Wildemann
	datagrapher(at)larsux(dot)de