HOWTO Setup AWStats - Revision history

Gordp: /* Restricted Access to AWStats Vhost */

2008-11-28T18:31:28Z

Restricted Access to AWStats Vhost

← Older revision		Revision as of 18:31, 28 November 2008
Line 50:		Line 50:

	== Restricted Access to AWStats Vhost ==		== Restricted Access to AWStats Vhost ==
	This is a variation you can use, in your /etc/apache2/vhost.d/ directory, perhaps naming this file '''awstats.conf''', or '''000_awstats.conf''':		This is a variation on the above file you can use if you want to only permit certain users to see your stats. Place the following in your /etc/apache2/vhost.d/ directory, perhaps naming this file '''awstats.conf''', or '''000_awstats.conf''':

	Alias /awstats/classes "/srv/www/localhost/htdocs/awstats/classes/"		Alias /awstats/classes "/srv/www/localhost/htdocs/awstats/classes/"

Gordp: /* Apache VHost Configuration */

2008-11-28T18:30:32Z

Apache VHost Configuration

@@ Line 48: / Line 48: @@
 </Directory>
 # awstats</pre>
 == Create the AWStats Config File==

Gordp: /* Schedule Daily Log Updates */

2008-11-28T17:09:53Z

Schedule Daily Log Updates

← Older revision		Revision as of 17:09, 28 November 2008
Line 81:		Line 81:

	Run that command once for the logs to be analysed the first time.		Run that command once for the logs to be analysed the first time.

			If you prefer Hourly log-updates, then create a file '''/etc/cron.hourly/awstats''' with this sort of content:
			#
			# /etc/cron.hourly/awstats
			#
			# parses apache log-files, and prepares them for viewing
			#

			cd /var/www/localhost/cgi-bin/ && ./awstats.pl -config=localhost -update > /dev/null

	== Access the Stats Website ==		== Access the Stats Website ==

Gordp: /* Create the AWStats Config File */

2008-11-28T17:00:24Z

Create the AWStats Config File

← Older revision		Revision as of 17:00, 28 November 2008
Line 65:		Line 65:
	* HostAliases"<projectname>.research.iat.sfu.ca www.<projectname>.research.iat.sfu.ca localhost 127.0.0.1 REGEX[myserver\.com$]"		* HostAliases"<projectname>.research.iat.sfu.ca www.<projectname>.research.iat.sfu.ca localhost 127.0.0.1 REGEX[myserver\.com$]"

	These HostAliases must match all ServerAliases ~~ion~~ your vhosts config file!		These HostAliases must match all ServerAliases in your vhosts config file!

	* DirData="/home/projects/<projectname>/htdocs/awstats		* DirData="/home/projects/<projectname>/htdocs/awstats

			Un-comment (around line 1270):
			LoadPlugin="geoip GEOIP_STANDARD"

	Restart apache for the settings to take effect		Restart apache for the settings to take effect

Gordp: /* Use webapp-config */

2008-11-28T16:50:44Z

Use webapp-config

← Older revision		Revision as of 16:50, 28 November 2008
Line 10:		Line 10:

	To setup another project, use webapp-config to add it to your project's htdocs directory:		To setup another project, use webapp-config to add it to your project's htdocs directory:
			# webapp-config -I -h <projectname> -u root -d /awstats awstats 6.5

	'''~~Note:~~''' ~~I don't think~~ this ~~is necessary anymore.~~		For '''machines other than tirpitz''' you can install with this command, which will place your app under /var/www/localhost/htdocs:
	# webapp-config -I -h ~~<projectname> -u root~~ -d /awstats awstats 6.5		# webapp-config -I -h localhost -d /awstats awstats 6.5

	webapp-config will output a lot of text, ignore it.		webapp-config will output a lot of text, ignore it.

			Typical upgrade commands:
			# webapp-config -U -d /awstats awstats 6.9

	== Apache VHost Configuration ==		== Apache VHost Configuration ==

Gordp: /* Install AWStats */

2008-11-28T16:40:58Z

Install AWStats

← Older revision		Revision as of 16:40, 28 November 2008
Line 3:		Line 3:
	== Install AWStats ==		== Install AWStats ==
	# emerge awstats		# emerge awstats
			Note: it's more fun to edit '''/etc/portage/package.use''' and add the '''geoip''' USE-flag.
			<br>

	== Use webapp-config ==		== Use webapp-config ==

Gordp: /* Access the Stats Website */

2007-03-12T14:37:51Z

Access the Stats Website

← Older revision		Revision as of 14:37, 12 March 2007
Line 75:		Line 75:
	== Access the Stats Website ==		== Access the Stats Website ==
	<nowiki>http://research.iat.sfu.ca/awstats.pl?config=<projectname></nowiki>		<nowiki>http://research.iat.sfu.ca/awstats.pl?config=<projectname></nowiki>

			For reference, the current awstats running on tirptitz can be found at:

			http://research.iat.sfu.ca/awstats.pl?config=infrastructure

Mmmark: Setup AWStats, an Apache Log Analyzer moved to HOWTO Setup AWStats

2006-04-05T00:48:18Z

Setup AWStats, an Apache Log Analyzer moved to HOWTO Setup AWStats

← Older revision	Revision as of 00:48, 5 April 2006
(No difference)

Mmmark at 19:33, 12 October 2005

2005-10-12T19:33:43Z

New page

This shows how to setup awstats on an apache server with vhosting. Make sure you have the '''vhosts''' use variable set on Gentoo. This article is aimed for AWStats on tirpitz.

== Install AWStats ==
# emerge awstats

== Use webapp-config ==
The standard projects directory must be listed in /etc/vhosts/webapp-config using the VHOST_ROOT variable. Currently this is set for any project that exists in: /home/projects/*/htdocs, as most projects on tirpitz have their webspace here.

To setup another project, use webapp-config to add it to your project's htdocs directory:

'''Note:''' I don't think this is necessary anymore.
# webapp-config -I -h <projectname> -u root -d /awstats awstats 6.5

webapp-config will output a lot of text, ignore it.

== Apache VHost Configuration ==
Copy this following section into your vhost file: /etc/apache2/vhosts.d/<projectname>.conf

<pre># awstats
Alias /awstats/classes "/usr/share/webapps/awstats/6.5/htdocs/classes/"
Alias /awstats/css "/usr/share/webapps/awstats/6.5/htdocs/css/"
Alias /awstats/icons "/usr/share/webapps/awstats/6.5/htdocs/icon/"
ScriptAlias /awstats/ "/usr/share/webapps/awstats/6.5/hostroot/cgi-bin/"
ScriptAlias /awstats "/usr/share/webapps/awstats/6.5/hostroot/cgi-bin/awstats.pl"
ScriptAlias /awstats.pl "/usr/share/webapps/awstats/6.5/hostroot/cgi-bin/awstats.pl"

<Directory "/usr/share/webapps/awstats/6.5/htdocs">
Options None
AllowOverride None
<IfModule mod_access.c>
Order allow,deny
Allow from all
</IfModule>
</Directory>
<Directory "/usr/share/webapps/awstats/6.5/hostroot/cgi-bin">
Options ExecCGI
AllowOverride None
<IfModule mod_access.c>
Order allow,deny
Allow from all
</IfModule>
</Directory>
# awstats</pre>

== Create the AWStats Config File==
# cd /etc/awstats
# cp awstats.researchtemplate.conf awstats.<projectname>.conf

Now edit that file to suit your project.

'''Note:''' most of this information is in your apache vhost file: /etc/apache/vhosts.d/<projectname>.conf

These are the variables you need to edit:

* LogFile="/var/log/apache2/<projectname>/access_log"

* SiteDomain="<projectname>.research.iat.sfu.ca"

* HostAliases"<projectname>.research.iat.sfu.ca www.<projectname>.research.iat.sfu.ca localhost 127.0.0.1 REGEX[myserver\.com$]"

These HostAliases must match all ServerAliases ion your vhosts config file!

* DirData="/home/projects/<projectname>/htdocs/awstats

Restart apache for the settings to take effect
# /etc/init.d/apache2 restart

== Schedule Daily Log Updates ==
Add the project to the daily cronjob: /etc/cron.daily/awstats

/usr/share/webapps/awstats/6.5/hostroot/cgi-bin/awstats.pl -config=<projectname> -update

Run that command once for the logs to be analysed the first time.

== Access the Stats Website ==
<nowiki>http://research.iat.sfu.ca/awstats.pl?config=<projectname></nowiki>