]> git.ipfire.org Git - thirdparty/AWStats.git/commitdiff
Updated documentation.
authoreldy <>
Sun, 30 May 2004 12:44:10 +0000 (12:44 +0000)
committereldy <>
Sun, 30 May 2004 12:44:10 +0000 (12:44 +0000)
16 files changed:
README.TXT
docs/awstats_changelog.txt
docs/awstats_compare.html
docs/awstats_config.html
docs/awstats_extra.html
docs/awstats_faq.html
docs/awstats_glossary.html
docs/awstats_license.html
docs/awstats_security.html
docs/awstats_setup.html
docs/awstats_tools.html
docs/awstats_upgrade.html
docs/awstats_webmin.html
docs/awstats_what.html
docs/index.html
wwwroot/cgi-bin/awstats.model.conf

index cb02d08872ea48e087eadd7b9be48598784ce83d..e61a8d950e43b68aef6f86f2e1689b434b454be9 100644 (file)
@@ -13,8 +13,8 @@ server log files (and even ftp servers or mail logs) on all Operating Systems.
 
 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
@@ -121,9 +121,9 @@ I - 3) Files
        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
 
 
 
index 33ff54896eec4f7e124bed32c2f904a76dcdcf52..521f77be4010bff846667ef8a3228e9d822357df 100644 (file)
@@ -4,8 +4,16 @@ $Revision$ - $Author$ - $Date$
 \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
index 886c19a08c4dc02c9cb0f64dd4a7faa847b368d2..1f68bffaf7dbccead8cdaa97131ed986c3448889 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index b4d10add58e8d46211cd4bfabc5e1b2b9f112e52..d56d5b1d738e039c4e612b04befc88daa4da8859 100644 (file)
@@ -20,7 +20,7 @@
 <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>
@@ -307,10 +307,12 @@ when reading it), follow the example:<br>
 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.
@@ -322,10 +324,10 @@ when reading it), follow the example:<br>
 <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
@@ -366,7 +368,7 @@ when reading it), follow the example:<br>
 <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: "|"
index 4208cd41d24a874ee490039f5e644f2a3bf2611b..5658eb510132ebc34289dd6ceb1deff9f7ab3c3d 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index 7238884243b13fae99a629b5f980f08b0b62e126..51e2737ac1f1f724313b66f03bf1e084fa5ad8c7 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index fe7cfc324ad3e6ce8e997706311b856a2d894493..c9a84ae6524e67667e91607c52b26899d97f1b8c 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index 03a45db7888c94a39b19607ef4ddf3835d0c8d06..851f21dafd99514a2559fc16ba24313f247fef82 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index 35e114d99bd404feef678ba7daccac43eabab242..05347d723ee3396b454dc15eb03d2d06c485cb44 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index 0a468880233e09fefd39788e21e23ac6c1c66aa1..e7d2c2e21686bb10f6f3e1a4a080fbc7e3f344f1 100644 (file)
@@ -20,7 +20,7 @@
 <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>
@@ -46,7 +46,7 @@ AWStats common use is made in 3 steps:<br>
 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>
@@ -54,23 +54,23 @@ If not, you can install a recent Perl interpreter from <a href="http://www.activ
 (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>
@@ -83,7 +83,7 @@ should get then in your new log file:<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>#
@@ -107,24 +107,24 @@ B) Then, configure.pl will add, if not already present, the following directives
 <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>
index 5f06a721fb558b50568eac6d6c6d23d5e9614c68..be07a9d512ace83c1fce9dcbbaf53c6487a6e6cd 100644 (file)
@@ -20,7 +20,7 @@
 <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>
@@ -40,7 +40,7 @@ All those tools are available in <b>tools</b> directory of AWStats distribution.
 
 <!--
 <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>
index 0b4e07a61548e7e3f3ce4f4f65726572800c50b8..4497c8aa908028dadbdb8c046e2690e2d89767d4 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index be81c38ebaade05c85bf37093d9f3e43885bdde5..07527e6d13f0c5da8977603ba601d4e09f15d10f 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index f9c17c3c3f23bf59e33c107de572c29eaa81372e..9a9bd9aff56b8f8b82d188d50794c87e6b979e08 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index 93312e66bc4112902f8493fd9fb032062fe3951c..32319f3e73c1eea8ce743a16e6201105ebb8f290 100644 (file)
@@ -20,7 +20,7 @@
 <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>
index e31c9f019983f98efec8d261077ec54ff2960268..183d5feeee3c34f7e2c545d0c135563a6df20725 100644 (file)
@@ -66,7 +66,7 @@ LogType=W
 # 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.
@@ -78,10 +78,10 @@ LogType=W
 #   %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
@@ -115,7 +115,7 @@ LogFormat=1
 
 
 # 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"