-- drraw dependencies

drraw requires:

* a working perl with the CGI module.  It was written and tested using version
  5.6.1.  It is known to run fine on UNIX (with Apache) as well as Windows
  (with Apache and IIS).
  Note that on Windows, ActivePerl 5.8.0 is required but that earlier versions
  may work as long as you comment out lines with calls to alarm().
* The RRDtool Perl module "RRDs" is also (unsurprisingly) needed.
  It is strongly recommended to use version 1.0.47 or above if possible,
  and version 1.0.36 at the very least.
  RRDtool 1.2.0 is to be avoided, use 1.2.1 or later.

-- drraw installation notes

drraw is a standalone CGI script with a separate configuration file.
The file drraw.cgi should be installed as a CGI script for your web server,
and the drraw.conf file should be copied to the same directory.

******************************************************************************
** To get going, the only configuration required is %datadirs in drraw.conf **
******************************************************************************

While all the configurable options are located in the drraw.conf file, you
will need to edit drraw.cgi if
(a) you want to put the drraw.conf file somewhere else,
(b) the RRDs.pm perl module was not installed in a directory mentioned
    in your perl's @INC,
(c) UNIX: /usr/local/bin/perl doesn't exist or isn't the perl you want to use
    OTHERS: Typically, web servers running on non UNIX platforms will ignore
            the first line of the script and are instead configured to use
            Perl (for example).  Microsoft IIS is an example of such a server.
            To get drraw working on such a server you have three choices:
            (1) Remove the -T option on the first line.  !!!NOT RECOMMENDED!!!
            (2) Configure the server to run Perl scripts with taint mode on.
                (This will affect _all_ Perl scripts.)
            (3) Work around the problem by creating a second special extension
                such as tcgi or tgi which is associated with taint mode Perl.

-- drraw security

Don't believe that because drraw is open source, it is secure.  This is just
stupid anti Microsoft propaganda.  To my knowledge, noone has ever thoroughly
reviewed drraw's code, meaning that while some care was taken to write a safe
tool, it comes with NO GUARANTEE at all.  Run it at your own risk.

This said, drraw uses Perl's "taint mode", and has a simple (and optional)
security system built-in to allow restricting read-write access.  In other
words, you should be fine (but don't take my word on it).

-- drraw contact

If you want to be informed about important news about drraw, such as new
releases, subscribe to the drraw-announce mailing list, either by sending a
mail including the "subscribe" keyword to drraw-announce-request@taranis.org,
or simply visit the following web page:
	http://web.taranis.org/mailman/listinfo/drraw-announce

Send bug reports to `drraw-bugs@taranis.org'.  A bug report is an adequate
description of the environment (versions of this package, the OS, Perl, the
CGI module and RRDtool) and of the problem: your input, what you expected,
what you got, and why you believe it to be wrong.  Diffs are welcome, but
they only describe a solution, from which the problem might be difficult
to infer.

Your feedback will help to make a better and more portable package.
Consider documentation errors as bugs, and report them as such.  If you
develop anything pertaining to `drraw' or have suggestions, share your
findings by writing to `drraw@taranis.org'.

-- $Id: INSTALL,v 1.11.2.1 2005/05/04 00:26:29 kalt Exp $
