Awstats

AWStats is a powerful tool which generates server statistics. AWstats works as a CGI or from command line and shows you all possible information your log contains in a graphical way.

Basic Installation

For installing the additional packages first activate community packages and update the package index

Install the required packages:

# apk add lighttpd php82 fcgi php82-cgi

Configure Lighttpd

Edit lighttpd.conf (/etc/lighttpd/lighttpd.conf) and uncomment the line:

Contents of /etc/lighttpd/lighttpd.conf

... include "mod_fastcgi.conf" ...

Edit mod_fastcgi.conf (/etc/lighttpd/mod_fastcgi.conf), find and change /usr/bin/php-cgi to /usr/bin/php-cgi82.

Contents of /etc/lighttpd/mod_fastcgi.conf

... "bin-path" => "/usr/bin/php-cgi82" # php-cgi ...

Start lighttpd service and add it to default runlevel

# rc-service lighttpd start # rc-update add lighttpd default

Installing Awstats

apk add awstats -U

In /etc/lighttpd/lighttpd.conf:

Contents of /etc/lighttpd/lighttpd.conf

... Change the base server root folder #server.document-root = var.basedir + "/htdocs" server.document-root = "/usr/lib/awstats" ...

Configuting Awstats

Run awstats_configure.pl

awstats_configure.pl

   -----> Running OS detected: Linux, BSD or Unix
   Do you want to continue setup from this NON standard directory [yN] ? y
   
   -----> Check for web server install
   Config file path ('none' to skip web server setup): none
   -----> Need to create a new config file ?  y
   
   -----> Define config file name to create
   Example: www.mysite.com
   Example: demo
   Your web site, virtual server or profile name: awstats
   
   -----> Define config file path
   >/etc/awstats 
   
   Press ENTER to continue...
   Press ENTER to finish...

Edit awstats.awstats.conf

   nano /etc/awstats/awstats.awstats.conf 
   Search the line LogFile=" " and configure your log path and file. e.g. LogFile="/var/log/messages"

Start http server and add to boot

/etc/init.d/lighttpd start && rc-update add lighttpd default

Browse

   http://AWSTATS_IP_NUMBER/cgi-bin/awstats.pl?config=awstats

Note: Awstats is not working yet with dansguardian logs.