AWStats - Revision history

Sstrutt: Added install from download

2013-07-22T08:42:41Z

Added install from download

← Older revision		Revision as of 08:42, 22 July 2013
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 ==

Sstrutt: /* Add New Robots to Detection */ Added "Error"

2013-07-17T13:01:11Z

Add New Robots to Detection: Added "Error"

← Older revision		Revision as of 13:01, 17 July 2013
Line 98:		Line 98:

	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).		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]]

Sstrutt: /* Add New Robots to Detection */ Fixed a couple of errors

2012-10-15T12:37:09Z

Add New Robots to Detection: Fixed a couple of errors

← Older revision		Revision as of 12:37, 15 October 2012
Line 81:		Line 81:
	== Add New Robots to Detection ==		== 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...		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>.		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>.
Line 93:		Line 94:
	'proximic','<a href="http://www.proximic.com/info/spider.php" title="Bot home page [new window]" target="_blank">Proximic</a>',		'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>		and an entry such as this for <code>RobotsSearchIDOrder_listx</code>
	'proximic',		'proximic',

Sstrutt: Added "Add New Robots to Detection"

2012-10-12T15:16:38Z

Added "Add New Robots to Detection"

@@ Line 78: / Line 78: @@
 ** 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>
 [[Category:Monitoring]]

Sstrutt: Added Applications category

2012-06-25T07:34:17Z

Added Applications category

← Older revision		Revision as of 07:34, 25 June 2012
Line 82:		Line 82:
	[[Category:Ubuntu]]		[[Category:Ubuntu]]
	[[Category:Installation]]		[[Category:Installation]]
			[[Category:Applications]]

Sstrutt: Added IIS logging fields info

2012-05-02T15:28:37Z

Added IIS logging fields info

← Older revision		Revision as of 15:28, 2 May 2012
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 ==
	# Install the package		# Install the package
	#* <code> apt-get install awstats </code>		#* <code> apt-get install awstats </code>
Line 31:		Line 31:
	</pre>		</pre>

	= Add a Web Site =		== 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 53:
	** <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>

Sstrutt: Initial creation - content from Ubuntu page

2012-04-16T11:00:58Z

Initial creation - content from Ubuntu page

New page

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

= Installation =
# Install the package
#* <code> apt-get install awstats </code>
# Edit the the generic template config file if required
#* <code> /etc/awstats/awstats.conf </code>
# Create apache config file for site with contents show below
#* eg <code> /etc/apache2/sites-enabled/awstats </code>
# Restart apache
#* <code> service apache2 restart </code>
# Site should now be available via URL similar to
#* http://yourserver/awstats/awstats.pl

<pre>
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>
</pre>

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

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

= One-off Update =
To perform a one-off update from a specific log file...
* <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.
Scheduled updates are configured in <code> /etc/cron.d/awstats </code>

[[Category:Monitoring]]
[[Category:Ubuntu]]
[[Category:Installation]]