2,187
edits
Difference between revisions of "AWStats"
Jump to navigation
Jump to search
Added install from download
m (Added IIS logging fields info) |
(Added install from download) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
== Installation == | == Installation == | ||
=== From Repository === | |||
# Install the package | # Install the package | ||
#* <code> apt-get install awstats </code> | #* <code> apt-get install awstats </code> | ||
| Line 30: | Line 31: | ||
</Directory> | </Directory> | ||
</pre> | </pre> | ||
=== 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 == | == Add a Web Site == | ||
| Line 78: | Line 91: | ||
** 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]] | |||