2,187
edits
(Initial creation - content from Ubuntu page) |
(Added install from download) |
||
(5 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
For further information see the AWStats website - http://awstats.sourceforge.net/ | For further information see the AWStats website - http://awstats.sourceforge.net/ | ||
= Installation = | == Installation == | ||
=== From Repository === | |||
# Install the package | # Install the package | ||
#* <code> apt-get install awstats </code> | #* <code> apt-get install awstats </code> | ||
Line 31: | Line 32: | ||
</pre> | </pre> | ||
= Add a Web Site = | === From Download === | ||
# Get the latest version from http://awstats.sourceforge.net/#DOWNLOAD | |||
#* EG <code> wget http://prdownloads.sourceforge.net/awstats/awstats-7.2.tar.gz </code> | |||
# Uncompress | |||
#* EG <code> tar -xzvf awstats-7.2.tar.gz </code> | |||
# If upgrading from a previous version, backup the old version | |||
#* EG <code> mv /usr/local/awstats/ /usr/local/awstats-v7.0 </code> | |||
# Copy the (new) software in | |||
#* EG <code> mv /home/user/awstats-7.2 /usr/local/awstats/ </code> | |||
# Ensure the web folder is executable | |||
#* EG <code> chmod -R a+rx awstats </code> | |||
== Add a Web Site == | |||
# Create a specific config file for the site to monitor | # Create a specific config file for the site to monitor | ||
#* <code> cp /etc/awstats/awstats.conf /etc/awstats/awstats.mysite.com.conf </code> | #* <code> cp /etc/awstats/awstats.conf /etc/awstats/awstats.mysite.com.conf </code> | ||
Line 53: | Line 66: | ||
** <code> URLReferrerWithQuery=1 </code> follows on from two above | ** <code> URLReferrerWithQuery=1 </code> follows on from two above | ||
= One-off Update = | === IIS Servers === | ||
By default, IIS server logs do not contain enough fields. Make sure the following are included (those in bold are the usually omitted culprits).. | |||
* date | |||
* time | |||
* c-ip | |||
* cs-username | |||
* cs-method | |||
* cs-uri-stem | |||
* cs-uri-query | |||
* sc-status | |||
* '''sc-bytes''' | |||
* '''cs-version''' | |||
* cs(User-Agent) | |||
* '''cs(Referer)''' | |||
To change the above in IIS7, in IIS Manager | |||
# Highlight the webserver (not a web site) | |||
# Double-click the '''Logging''' feature | |||
# Click on the '''Select Fields''' button | |||
== One-off Update == | |||
To perform a one-off update from a specific log file... | To perform a one-off update from a specific log file... | ||
* <code> /usr/lib/cgi-bin/awstats.pl -config=server -LogFile=access.log </code> | * <code> /usr/lib/cgi-bin/awstats.pl -config=server -LogFile=access.log </code> | ||
** 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. | ** 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 <code> /etc/cron.d/awstats </code> | Scheduled updates are configured in <code> /etc/cron.d/awstats </code> | ||
== Add New Robots to Detection == | |||
Locate the <code>robots.pm</code>, likely to be in one of the following locations, create a backup and then edit... | |||
* <code> ./usr/share/awstats/lib/robots.pm </code> | |||
* <code> ./usr/local/awstats/wwwroot/cgi-bin/lib/robots.pm </code> | |||
Robots need to be added to two arrays, <code>RobotsSearchIDOrder_listx</code> and <code>RobotsHashIDLib</code>. <code>RobotsSearchIDOrder_listx</code> is just an index, so if adding a number of new robots, create your listings for <code>RobotsHashIDLib</code>, then create a copy and delete the extraneous bits for <code>RobotsSearchIDOrder_listx</code>. | |||
Add new entries to the end of the arrays, just above the catch-alls. | |||
So for a robot user agent string such as... | |||
(compatible; proximic; +http://www.proximic.com/info/spider.php) | |||
Create a entry such as this for <code>RobotsHashIDLib</code> | |||
'proximic','<a href="http://www.proximic.com/info/spider.php" title="Bot home page [new window]" target="_blank">Proximic</a>', | |||
and an entry such as this for <code>RobotsSearchIDOrder_listx</code> | |||
'proximic', | |||
Note that robots will only be detected on new stats runs, so to update historical stats, delete the history files and recreate from archived logs (if you have available). | |||
=== Errors === | |||
If you get the following error similar to the following after updating the robots file... | |||
* <code>Error: Not same number of records of RobotsSearchIDOrder_listx (total is 789 entries) and RobotsHashIDLib (787 entries without 'unknown') in Robots database.</code> | |||
You've probably added a duplicate robot entry, which will need to be removed/merged with the existing entry - search your backup robots.pm file for a robot that you're trying to add. | |||
[[Category:Monitoring]] | [[Category:Monitoring]] | ||
[[Category:Ubuntu]] | [[Category:Ubuntu]] | ||
[[Category:Installation]] | [[Category:Installation]] | ||
[[Category:Applications]] |