From b8efa8bc85b3bea8bc2aed9a09701cf8003b0b89 Mon Sep 17 00:00:00 2001 From: Julien Valroff Date: Tue, 17 Aug 2010 22:27:07 +0200 Subject: Explain how to avoid internal errors when running apache in its default configuration --- debian/README.Debian | 37 ++++++++++++++++++++++++++++++------- debian/changelog | 4 +++- 2 files changed, 33 insertions(+), 8 deletions(-) diff --git a/debian/README.Debian b/debian/README.Debian index 169fa54..b49be51 100644 --- a/debian/README.Debian +++ b/debian/README.Debian @@ -10,13 +10,36 @@ 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 + + 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 Thu, 25 Dec 2003 23:50:13 +0100 - -- Julien Valroff Fri, 13 Aug 2010 08:50:13 +0200 + -- Julien Valroff Fri, 17 Aug 2010 22:18:13 +0200 diff --git a/debian/changelog b/debian/changelog index f9a70bf..9370d3b 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,8 +1,10 @@ mailgraph (1.14-4) unstable; urgency=low * Recommend apache2 instead of apache + * Explain in README.Debian how to avoid internal errors + when running Apache with the default configuration (Closes: #513527) - -- Julien Valroff Mon, 16 Aug 2010 10:30:13 +0200 + -- Julien Valroff Tue, 17 Aug 2010 22:25:55 +0200 mailgraph (1.14-3) unstable; urgency=low -- cgit v1.2.3