summaryrefslogtreecommitdiff
path: root/debian/README.Debian
blob: b49be51a2eeb3a9ab57524f3ff4a77eb8c02cdb4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Mailgraph gathers statistics about traffic passing through a Postfix
mail server and presents them in graphical form on a web page. It does
this using the excellent RRDTOOL
(http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/).

This Debian package installs itself, optionally, as a daemon that
will constantly gather the statistics it needs. You really need to turn
this option on for it to be of any use. The statistics themselves are
served up by a web CGI program, /usr/lib/cgi-bin/mailgraph.cgi. With any
normal Debian web server install, this should be accessible as
http://localhost/cgi-bin/mailgraph.cgi


Note for Lighttpd users:

  Lighttpd doesn't take *.cgi? values, hence the graphs are not displayed 
  without extra configuration.
  An example of such configuration is available in
    /usr/share/doc/mailgraph/examples/lighttpd.conf

  It should be amended to suit your needs, and copied to eg.
   /etc/lighttpd/conf-available/50-mailgraph.conf


Note for Apache users:

  The default configuration of the Debian Apache packages is so that
  everything in /usr/lib/cgi-bin will be handled as executable/CGI script.

  This leads to internal errors, eg:
    (13)Permission denied: exec of '/usr/lib/cgi-bin/mailgraph.css' failed
    Premature end of script headers: mailgraph.css

  To avoid this, you might want to add a handler to your configuration, eg:
    AddHandler cgi-script .cgi

  This means only files with a .cgi extension are handled as executable/CGI scripts.
  You can obviously add other extensions required by your configuration.

  The AddHandler requires mod_mime to be enabled. See the official Apache documentation
  for more information: http://httpd.apache.org/docs/2.2/mod/mod_mime.html#addhandler
 

 -- Norbert Tretkowski <nobse@debian.org>  Thu, 25 Dec 2003 23:50:13 +0100
 -- Julien Valroff <julien@kirya.net>  Fri, 17 Aug 2010 22:18:13 +0200