Difference between revisions of "Awstats"

From ArchWiki
Jump to: navigation, search
Line 8: Line 8:
 
== Installing ==
 
== Installing ==
 
=== mod_perl ===
 
=== mod_perl ===
mod_perl is required to run awstats with apache. {{:ArchTrack/pkg|mod_perl}} package is available in repo extra. So you can install it using pacman.
+
<tt>mod_perl</tt> is required to run awstats with apache. {{:ArchTrack/pkg|mod_perl}} package is available in repo extra. So you can install it using pacman.
  
 
  # pacman -S mod_perl
 
  # pacman -S mod_perl
Line 19: Line 19:
 
== Configuring ==
 
== Configuring ==
 
=== Enable mod_perl for Apache ===
 
=== Enable mod_perl for Apache ===
To enable mod_perl in apache, you should add following line to apache configuration (/etc/httpd/conf/httpd.conf).
+
To enable <tt>mod_perl</tt> in apache, you should add following line to apache configuration (/etc/httpd/conf/httpd.conf).
 
   LoadModule perl_module modules/mod_perl.so
 
   LoadModule perl_module modules/mod_perl.so
  
Line 56: Line 56:
  
 
   Include conf/extra/httpd-awstats.conf
 
   Include conf/extra/httpd-awstats.conf
 +
 +
Now if you have done all steps correctly, you should be able to see awstats running on http://domaincomeshere.com/awstats/awstats.pl '''of course after restarting apache'''. One last thing, which is the actual aim, make awstats read logs and convert them to stats.
 +
 +
=== Awstats Configuration ===
 +
Package in AUR comes with a out of the box hourly cron to update stats shown on awstats. This cron script reads awstats configuration files in <tt>/etc/awstats</tt>

Revision as of 23:33, 11 April 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Tango-document-new.pngThis article is a stub.Tango-document-new.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:Awstats#)

I am planning to update this page to contain full installation and configuration of awstats for apache as I have time to. If you want to add something, go ahead. -th0th

Installing

mod_perl

mod_perl is required to run awstats with apache. ArchTrack/pkg package is available in repo extra. So you can install it using pacman.

# pacman -S mod_perl

Awstats

Awstats package is available in AUR. You can use yaourt to build it or you can obtain tarball from AUR and build it yourself.

$ yaourt -S awstats

Configuring

Enable mod_perl for Apache

To enable mod_perl in apache, you should add following line to apache configuration (/etc/httpd/conf/httpd.conf).

 LoadModule perl_module modules/mod_perl.so

Configure Apache to log for Awstats

By default awstats requires Apache to record access logs as 'combined'. Unless you want a different behavior, you should set your access log format as 'combined'. To do so, your apache configuration should look like this:

 <VirtualHost *:80>
     ServerAdmin zxc@returnfalse.net
     DocumentRoot "/srv/http/xxx"
     ServerName www.returnfalse.net
     ErrorLog "/var/log/httpd/returnfalse-error_log"
     CustomLog "/var/log/httpd/returnfalse-access_log" combined
 </VirtualHost>

The important line here is:

 CustomLog "/var/log/httpd/returnfalse-access_log" combined
Warning: At this point, if apache has started to log access with different format, awstats will complain about this because it can't read. So if you are changing apache's log format now, you probably should delete old log files not to confuse Awstats.

Including Awstats Configuration to Apache's Configuration

If you set the log format, then next step is including awstats config file to apache. The package in AUR has a default one, and it's working without any problem. But incase you want to create your own configuration, default one is this:

 Alias /awstatsclasses "/srv/http/awstats/classes/"
 Alias /awstatscss "/srv/http/awstats/css/"
 Alias /awstatsicons "/srv/http/awstats/icon/"
 ScriptAlias /awstats/ "/srv/http/awstats/cgi-bin/"
 
 <Directory "/srv/http/awstats">
     Options None
     AllowOverride None
     Order allow,deny
     Allow from all
 </Directory>

Include this file (in AUR case, the path is /etc/httpd/conf/extra/httpd-awstats.conf) to apache's main configuration:

 Include conf/extra/httpd-awstats.conf

Now if you have done all steps correctly, you should be able to see awstats running on http://domaincomeshere.com/awstats/awstats.pl of course after restarting apache. One last thing, which is the actual aim, make awstats read logs and convert them to stats.

Awstats Configuration

Package in AUR comes with a out of the box hourly cron to update stats shown on awstats. This cron script reads awstats configuration files in /etc/awstats