License: GNU GPL (GNU General Public License. See LICENSE file),
OSI Certified Open Source Software license.
-Version: 6.1
-Release date: May 2004
+Version: 6.2
+Release date: July 2004
Platforms: All (Linux, NT, BSD, Solaris and other *NIX's, BeOS, OS/2...)
Author: Laurent Destailleur <eldy@users.sourceforge.net>
AWStats official web site and latest version: http://awstats.sourceforge.net
wwwroot/css Samples of CSS files
wwwroot/js Javascript sources for "Misc" feature
tools/* Other provided tools
+ tools/webmin/awstats-x.x.wbm A Webmin module for AWStats
tools/xslt/awstats61.xsd AWStats XML database schema descriptor
tools/xslt/* Demo to manipulate AWStats XML database
- tools/webmin/awstats-x.x.wbm A Webmin module for AWStats
\r
6.2\r
\r
+New features/improvements:\r
+- None\r
+\r
+Fixes:\r
+- Fix not recognized %time3 tag in LogFormat\r
+\r
Other/Documentation:\r
-- Minor change on documentation.\r
+- Some changes to allow plugins to add new charts.\r
+- Updated documentation.\r
+- Renamed configure.pl into awstats_configure.pl.\r
\r
\r
6.1\r
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
4.0+ for tags %gzipratio,%syslog<br>
4.1+ for tag %virtualname<br>
5.6+ for tag %deflateratio<br>
+6.1+ for tag %time4<br>
+6.2+ for tag %time3<br>
<br># Enter here your log format (Must agree with your web server. See setup
<br># instructions in README.txt to know how to configure your web server to have
<br># the required log format).
-<br># Possible values: 1,2,3,4,5 or "your_own_personalized_log_format"
+<br># Possible values: 1,2,3,4 or "your_own_personalized_log_format"
<br># 1 - Apache or Lotus Notes/Domino native combined log format (NCSA combined/XLF/ELF log format)
<br># 2 - Old IIS log format (IIS W3C log format). See FAQ for IIS 6.x.
<br># 3 - Webstar native log format.
<br># %host Host client name or IP address
<br># %lognamequot Authenticated login/user with format: "alex"
<br># %logname Authenticated login/user with format: alex
-<br># %time1 Date and time with format: [dd/mmm/yyyy:hh:mm:ss +0000] or [dd/mmm/yyyy:hh:mm:ss]
+<br># %time1 Date and time with format: [dd/mon/yyyy:hh:mm:ss +0000] or [dd/mon/yyyy:hh:mm:ss]
<br># %time2 Date and time with format: yyyy-mm-dd hh-mm-ss
<br># %time3 Date and time with format: Mon dd hh:mm:ss
-<br># %time4 Date and time with format: dddddddddd
+<br># %time4 Date and time with unix timestamp format: dddddddddd
<br># %methodurl Method and URL with format: "GET /index.html HTTP/x.x"
<br># %methodurlnoprot Method and URL with format: "GET /index.html"
<br># %method Method with format: GET
<a name="LogSeparator"><b>LogSeparator</b></a><br>
<b>Version : </b>5.0+<br>
<br># If your log field's separator is not a space, you can change this parameter.
-<br># This parameter is not used if LogFormat is a predefined value (1,2,3,4,5,6)
+<br># This parameter is not used if LogFormat is a predefined value (1,2,3,4)
<br># Example: " "
<br># Example: "\t"
<br># Example: "|"
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
Before starting, check that your Perl version is at least 5.005_03 (or higher) by running the <i>perl -v</i> command.
If not, you can install a recent Perl interpreter from <a href="http://www.activestate.com/ActivePerl/">ActivePerl</a> (<font color=#221188>Win32</font>) or <a href="http://www.perl.com/pub/language/info/software.html">Perl.com</a> (<font color=#221188>Unix/Linux/Other</font>).<br>
-->
-<br><a name="INSTALL"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>Step 1 : Install and Setup with configure.pl</u></H2></a>
+<br><a name="INSTALL"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>Step 1 : Install and Setup with awstats_configure.pl</u></H2></a>
<br>
<a name="INSTALLAPACHE"><b>A) With Apache or compatible server (on Unix/Linux, Windows, MacOS...)</b></a><br>
<br>
(if you use a package provided with a Linux distribution or Windows installer, action done in step 1-1
might have already be done, if you don't know you, do it again)<br>
<br>
-After downloading and extracting the AWStats package, you should run the configure.pl script to do
+After downloading and extracting the AWStats package, you should run the awstats_configure.pl script to do
several setup actions.
You will find it in the AWStats <b>tools</b> directory (If using the windows installer, the script is
automatically launched):<br>
-<b><i>perl configure.pl</i></b><br>
+<b><i>perl awstats_configure.pl</i></b><br>
<ul>
-<u>This is what the script do/ask (you can do all those steps manually instead of running configure.pl if you prefer):</u><br>
+<u>This is what the script do/ask (you can do all those steps manually instead of running awstats_configure.pl if you prefer):</u><br>
<br>
-A) configure.pl try to find your Apache web server config file (ask path if not found) and check
+A) awstats_configure.pl try to find your Apache web server config file (ask path if not found) and check
inside your server log format configuration.
-If you use a <b>common</b> log, configure.pl will
+If you use a <b>common</b> log, awstats_configure.pl will
suggest to change it to have <b>NCSA combined/XLF/ELF</b> log format (you can use your own log
format but this predefined logformat is often the best choice and make setup easier).<br>
-If you answer yes, configure.pl will modify your <b>httpd.conf</b> to change all the
+If you answer yes, awstats_configure.pl will modify your <b>httpd.conf</b> to change all the
following directives:<br>
<i>CustomLog /yourlogpath/yourlogfile common</i><br>
into<br>
<i>62.161.78.75 - - [dd/mmm/yyyy:hh:mm:ss +0000] "GET / HTTP/1.1" 200 1234 "http://www.from.com/from.html" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</i><br>
<br>
-B) Then, configure.pl will add, if not already present, the following directives to your Apache config file
+B) Then, awstats_configure.pl will add, if not already present, the following directives to your Apache config file
(note that the "/usr/local/awstats/wwwroot" path might differ according to your distribution or OS:<br>
<i>
<br>#
<br>
<br>
-C) configure.pl restart Apache to apply the changes made in A and B (if changes were made).<br>
+C) awstats_configure.pl restart Apache to apply the changes made in A and B (if changes were made).<br>
<br>
-D) configure.pl will ask you a name for a config profile file. Enter here the name of your
+D) awstats_configure.pl will ask you a name for a config profile file. Enter here the name of your
web server or any analysis profile name, for example <b>myvirtualhostname</b>.<br>
-So configure.pl will copy the file <b>awstats.model.conf</b> file into a new file
+So awstats_configure.pl will copy the file <b>awstats.model.conf</b> file into a new file
named <b>awstats.myvirtualhostname.conf</b>.
You can use the value of your choice instead of "myvirtualhostname". This new file is stored into:<br>
- For Linux/BSD/Unix users: /etc/awstats.<br>
- For Mac OS X, Windows and other OS: Same directory than awstats.pl (so cgi-bin).<br>
<br>
-E) configure.pl ends.<br>
+E) awstats_configure.pl ends.<br>
<br>
</ul>
<font style="color: #111155"><b>* Step 1-2</b>:</font><br>
-Once a config file has been automatically created (by configure.pl, by you package
+Once a config file has been automatically created (by awstats_configure.pl, by you package
installer or just by a manual copy of awstats.model.conf), it's important to edit it manually and change the "MAIN PARAMETERS"
to match all your needs:<br>
<br>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<!--
<br>
-<br><a name="configure"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>configure.pl</u></H2></a>
+<br><a name="awstats_configure"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>awstats_configure.pl</u></H2></a>
<br>This script creates one config file for each web servers provided by Apache.
<br>After running this tool, AWStats can immediatly be used.<br>
<br>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.1 Documentation</b></font><br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 6.2 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
# Enter here your log format (Must match your web server config. See setup
# instructions in documentation know how to configure your web server to have
# the required log format).
-# Possible values: 1,2,3,4,5 or "your_own_personalized_log_format"
+# Possible values: 1,2,3,4 or "your_own_personalized_log_format"
# 1 - Apache or Lotus Notes/Domino native combined log format (NCSA combined/XLF/ELF log format)
# 2 - Old IIS log format (IIS W3C log format). See FAQ for IIS 6.x.
# 3 - Webstar native log format.
# %host Host client name or IP address
# %lognamequot Authenticated login/user with format: "alex"
# %logname Authenticated login/user with format: alex
-# %time1 Date and time with format: [dd/mmm/yyyy:hh:mm:ss +0000] or [dd/mmm/yyyy:hh:mm:ss]
+# %time1 Date and time with format: [dd/mon/yyyy:hh:mm:ss +0000] or [dd/mon/yyyy:hh:mm:ss]
# %time2 Date and time with format: yyyy-mm-dd hh:mm:ss
# %time3 Date and time with format: Mon dd hh:mm:ss
-# %time4 Date and time with format: dddddddddd
+# %time4 Date and time with unix timestamp format: dddddddddd
# %methodurl Method and URL with format: "GET /index.html HTTP/x.x"
# %methodurlnoprot Method and URL with format: "GET /index.html"
# %method Method with format: GET
# If your log field's separator is not a space, you can change this parameter.
-# This parameter is not used if LogFormat is a predefined value (1,2,3,4,5,6)
+# This parameter is not used if LogFormat is a predefined value (1,2,3,4)
# Backslash can be used as escape character.
# Example: " "
# Example: "\t"