Added on September 4th, 2008
The original war file is no longer available, please find a copy here
I’ve found this little tutorial two years ago and it helps me a lot with awstats on tomcat, i hope it can be useful for you….
Author: John Smith (first website found) it seems to have a mirror here
- Perl 5.2 or above
- Tomcat 5 (I can’t see any reason for Tomcat 4 not to work, I haven’t tried it, though)
awstats.war file (see downloads) >> The original war file is no longer available, please find a copy here
Changing Tomcat access logs format
Tomcat access logs format isn’t exactly what we need. We could also have modified AWStats configuration files, but with the loss of important information. Thus, let’s make Tomcat logs compatible with AWStats. Logs are configured in
[Tomcat_install]/conf/server.xml. They might look something like:
<Valve className=“org.apache.catalina.valves.AccessLogValve” directory=“logs” prefix=“localhost_access_log.” suffix=“.txt” pattern=“common” resolveHosts=“false”/>
Normally this lines are commented. Just take in mind they should appear, uncommented, within your
We will replace the valve definition with this one:
<Valve className=“org.apache.catalina.valves.AccessLogValve” directory=“logs” prefix=“www_mydomain_com_access_log.” suffix=“.log” pattern=“combined” fileDateFormat=“dd-MM-yy” resolveHosts=“false”/>
Enable Perl scripts
Tomcat has disabled by default CGI executions. This is because CGIs do not conform Tomcat security box. But we know exactly what we are going to do, aren’t we ….. ?
The only thing you need to do is renaming
[Tomcat_install]/server/lib/servlets-cgi.jar. This will enable AWStats Perl scripts to execute on Tomcat server. When it’s done, restart Tomcat.
There is something more done through
awstats.war file’s web.xml. You might want to look at this file once downloaded.
AWStats is included in
awstats.war file, therefore you will not need to install AWStats by hand.
awstats.war file. Will suffice copying this file into
[Tomca_install]/webapps folder, but in case your Tomcat is configured not to auto-deploy war files, unzip it yourself. By default would create an
Although you could change default context, isn’t a good idea. At least not to start with. Better make it work and then think about changing things.
This is the hardest part, did you already take a coffe?
First we will make some assumptions, are these ones:
- awstats.war was deployed into
/awstats default context. See Install AWStats.
- Our domain is
Now, go to
[Tomca_install]/webapps/awstats/WEB-INF/cgi-bin folder. Next instructions make the assumption this is your current working folder.
You can use any text editor of your preference. Now, we will change some file default values. You must look for the attributes and change their values as shown below:
LogFile="[TI]/webapps/awstats/WEB-INF/tools/logresolvemerge.pl [TI]/logs/*.log |"
[TI] with full path to Tomcat. And
www.mydomain.com with your domain name.
Update site statistics.
Here you have two choices:
awstats.www.mydomain.com.conf file, see above. This will allow updating from the web browser with:
- Using Telnet or SSH, go to
[Tom ca_install]/webapps/awstats/WEB-INF/cgi-bin folder and run
perl awstats.pl -config=www.mydomain.com -update.
View site statistics.
http://www.mydomain.com/awstats/cgi-bin/awstats.pl?config=www.mydomain.com. That was all.
Creating separated domain statistics.
From the instructions above, everything is valid for creating separated domain statistics, except for one thing:
awstats.www.mydomain.com.conf we said:
LogFile=“[TI]/webapps/awstats/WEB-INF/tools/logresolvemerge.pl [TI]/logs/*.log |”
This line was gathering the whole set of log files, and this is against having statistics appart for each domain. We should replace this line to match the log files for the corresponding domain, as we said when changing Tomcat access logs format:
LogFile=“[TI]/webapps/awstats/WEB-INF/tools/logresolvemerge.pl [TI]/logs/www_mydomain_com*.log |”
Important! Don’t omit the asterisk in pointing the log files. Take in mind that Tomcat will create an access log file for each day, and that final file’s name will include the date.