Qmail Statistics (AWStats)

From SME Server
Jump to: navigation, 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.

Screenshot

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


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


Important.png Note:
For SME9 and newer version see talk page Talk:Qmail_Statistics_(AWStats)

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

moving data from old server to new one

prior to Run the first update manually

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

copy|move|rsync all files from old server to new one in following location

/home/e-smith/awstats/