awstats-apache2 for Debian -------------------------------------------------------------------------------- OVERVIEW -------------------------------------------------------------------------------- This package is a supplement to the official Debian awstats package. You should read /usr/share/doc/awstats/README.Debian. -------------------------------------------------------------------------------- CONTENTS -------------------------------------------------------------------------------- This package installs/updates the following components: 1. /usr/lib/cgi-bin/awstats 2. /var/log/apache2/*.log 3. /etc/logrotate.d/apache2 /usr/lib/cgi-bin/awstats is a CGI script that lists all of the available reports (with HREF links to awstat.pl to show the report). The list of available reports is based on the names of the configuration files found in /etc/awstats. The default permissions of the log files in /var/log/apache2 do not allow awstats to read them. This package changes the permissions to world-readable and also changes the logrotate.d configuration file so that future Apache log files will also be world-readable. -------------------------------------------------------------------------------- USAGE -------------------------------------------------------------------------------- You may wish to increase the number of weeks of log files to save by editing /etc/logrotate.d/apache2 and change the "rotate" line as described in the man page for logrotate. Although AWStats does not need access to old log files after it has processed them, you may decide later to change your AWStats configuration file in which case you may need to delete the AWStats database files and rerun awstats on the older log files to get the newly configured statistics. To configure Apache 2.0 to access the CGI scripts: cp -p /usr/share/doc/awstats/examples/awstats.conf /etc/apache2/conf.d/ invoke-rc.d apache2 restart You will now be able to access reports from the following URL: http://hostname/cgi-bin/awstats NOTE: when you remove this package with the --purge option, the log file permissions will revert to not world-readable. -------------------------------------------------------------------------------- -- Ken Neighbors , Thu Apr 22 17:27:00 2010