Qmail Statistics (AWStats)

From SME Server
Revision as of 20:38, 26 September 2008 by Mweinber (talk | contribs) (uninstall instructions)
Jump to navigation Jump to search


Introduction

Quoted from the AWStats homepage: AWStats is a free powerful and featureful tool that generates advanced web, streaming, ftp or mail server statistics, graphically. This log analyzer works as a CGI or from command line and shows you all possible information your log contains, in few graphical web pages. It uses a partial information file to be able to process large log files, often and quickly. It can analyze log files from all major server tools like Apache log files (NCSA combined/XLF/ELF log format or common/CLF log format), WebStar, IIS (W3C log format) and a lot of other web, proxy, wap, streaming servers, mail servers and some ftp servers. Read more...

This Howto describes the Qmail statistics setup.

 

Installation

Download the RPM from the AWstats homepage

wget http://prdownloads.sourceforge.net/awstats/awstats-6.7-1.noarch.rpm

Install the RPM

/usr/bin/yum -y localinstall awstats-6.7-1.noarch.rpm


  Note:
If you have the AWStats contrib installed, use this install command
rpm -ivh --force awstats-6.7-1.noarch.rpm



Setup

Download the setup script qmail-awstats-setup.v2.sh and run it.

wget http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Qmail-AWStats/qmail-awstats-setup.v2.sh
bash qmail-awstats-setup.v2.sh

This script...

  • creates an AWStats config file for Qmail
  • creates a data directory for AWStats
  • installs a logfile preprocessor script
  • creates a custom template for httpd.conf
  • creates a custom template for crontab


Run the first update manually

/usr/local/awstats/wwwroot/cgi-bin/awstats.pl -update -config=mail

Note: The setup script was updated to version 2 on Sep 7 2008. See forum thread http://forums.contribs.org/index.php?topic=42024.msg197025#msg197025

Usage

Point your browser to https://YOUR_SMESERVER_IP/awstats/awstats.pl?config=mail and login as admin.

Uninstall

/bin/rm -f /etc/e-smith/templates-custom/etc/crontab/awstats
expand-template /etc/crontab
/bin/rm -f /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/86awstats
expand-template /etc/httpd/conf/httpd.conf
service httpd-e-smith restart
/bin/rm -f /etc/awstats/awstats.mail.conf
/bin/yum -y erase awstats-6.7-1