AWStats

For further information see the AWStats website - http://awstats.sourceforge.net/

Installation

1. Install the package
   • apt-get install awstats
2. Edit the the generic template config file if required
   • /etc/awstats/awstats.conf
3. Create apache config file for site with contents show below
   • eg /etc/apache2/sites-enabled/awstats
4. Restart apache
   • service apache2 restart
5. Site should now be available via URL similar to
   • http://yourserver/awstats/awstats.pl

Alias /awstatsclasses "/usr/share/awstats/lib/"
Alias /awstats-icon/ "/usr/share/awstats/icon/"
Alias /awstatscss "/usr/share/doc/awstats/examples/css"
ScriptAlias /awstats/ /usr/lib/cgi-bin/

<Directory /usr/lib/cgi-bin/>
        Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
        Order allow,deny
        Allow from all
</Directory>

<Directory /usr/share/awstats/>
        Order allow,deny
        Allow from all
</Directory>

Add a Web Site

1. Create a specific config file for the site to monitor
   • cp /etc/awstats/awstats.conf /etc/awstats/awstats.mysite.com.conf
2. Edit the config file for the site, specifically (see below for further options)
   • LogFile=”/path/to/your/domain/access.log”
   • LogFormat=1 (this will give you more detailed stats)
   • SiteDomain=”mysite.com”
   • HostAliases=”www.mysite.com localhost 127.0.0.1" (example for a local site)
3. Perform an initial stats gather for the site
   • /usr/lib/cgi-bin/awstats.pl -config=mysite.com -update
4. Test that you can see some stats, using URL similar to
   • http://yourserver/awstats/awstats.pl?config=mysite.com
5. Add a scheduled job to crontab to update automatically
   • crontab -e
   • EG every 30 mins */30 * * * * /bin/perl /usr/lib/cgi-bin/awstats.pl -config=mysite.com -update >/dev/null

Further options

• Wiki sites (and other sites where an URL parameter can specify a specific page)
  • URLWithQuery=1 - useful for Wiki's etc where query param indicates a different page
  • URLWithQueryWithOnlyFollowingParameters="title" - only treats variances in param title as distinct pages
  • URLReferrerWithQuery=1 follows on from two above

One-off Update

To perform a one-off update from a specific log file...

• /usr/lib/cgi-bin/awstats.pl -config=server -LogFile=access.log
  • Updates can only be added in chronological order, therefore you may need to delete the data file for a particular month, and rebuild it entirely.

Scheduled updates are configured in /etc/cron.d/awstats