experience size limit errors on files larger than 2 or 4 GB.
If limit is Perl only, try to use a Perl version compiled with "large file" option.<br>
If you can't find it nor build it, you can try to use a LogFile parameter that looks like this
-<i>LogFile="cat /yourlogfilepath/yourlogfile |"</i> instead of
-<i>LogFile="/yourlogfilepath/yourlogfile"</i><br>
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
+<i>LogFile="cat /yourlogfilepath/yourlogfile |"</i>
+</td></tr></table>
+instead of
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
+<i>LogFile="/yourlogfilepath/yourlogfile"</i>
+</td></tr></table>
<br>
<a name="FTP"></a><br>
<br>
To have the change effective, stop your server, remove old log file /var/log/xferlog and restart the server.<br>
Download a file by FTP and check that your new log file looks like this:<br>
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>[01/Jan/2001:21:49:57 +0200] ftp.server.com user RETR /home/fileiget.txt 226 1499</i><br>
+</td></tr></table>
<br>
2- Then setup AWStats to analyze the FTP log file:<br>
<br>
<u>For Realmedia</u><br>
<br>
Your log file will probably looks like this:<br>
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>
216.125.146.50 - - [16/Sep/2002:14:57:21 -0500] "GET cme/rhythmcity/rcitycaddy.rm?cloakport=8080,554,7070 RTSP/1.0" 200 6672 [Win95_4.0_6.0.9.374_play32_NS80_en-US_586] [80d280e1-c9ae-11d6-fa53-d52aaed98681] [UNKNOWN] 281712 141 3 0 0 494<br>
</i>
+</td></tr></table>
<br>
Copy config awstats.model.conf file to "awstats.mediaserver.conf".
Modify this new config file:
<u>For Windows Media Server / Darwin Streaming Server</u><br>
<br>
1- If your Windows Media / Darwin streaming Server version allows it, setup your log format to write the following fields:
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>
-<br>c-ip
+c-ip
<br>date
<br>time
<br>cs-uri-stem
<br>channelURL
<br>sc-bytes
</i>
+</td></tr></table>
<br>
To have the change effective, stop your server, remove old log files and restart the server.<br>
Listen to streaming files and check that your new log file looks like this:<br>
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>
80.223.91.37 2002-10-08 14:18:58 mmst://mydomain.com/mystream 0 106 1 200 {F4A826EE-FA46-480F-A49B-76786320FC6B} 8.0.0.4477 fi-FI - - wmplayer.exe 8.0.0.4477 Windows_2000 5.1.0.2600 Pentium 0 0 20702 mms TCP Windows_Media_Audio_9 - - 277721
</i>
+</td></tr></table>
<br>
<br>
If your Windows Media/Darwin Streaming Server version does not allow to define your log format:<br>
Just follow instructions in step 2 directly but use the log format string found in first lines
of your log files (Just after the "<i>#Fields:</i>" string) as value for AWStats LogFormat
parameter. For example, you could have a LogFormat defined like this:<br>
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>
LogFormat="c-ip date time c-dns cs-uri-stem c-starttime x-duration c-rate
c-status c-playerid c-playerversion c-playerlanguage cs(User-Agent)
c-pkts-recovered-resent c-buffercount c-totalbuffertime c-quality s-ip s-dns
s-totalclients s-cpu-util"
</i>
+</td></tr></table>
<br>This means you don't use the AWStats tags but AWStats can often also understand all the IIS and/or
Windows Media Server tags.<br>
To help you, this is some common cases of log file format, and
the corresponding value for LogFormat you must use in your AWStats config file:<br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (<b>NCSA combined/XLF/ELF</b> log format):</u><br>
<i>62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 1234 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</i><br>
You must use : <i>LogFormat=1</i><br>
This is same than: <i>LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (<b>NCSA combined with several virtualhostname</b> sharing same log file).</u><br>
<i>virtualserver1 62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 1234 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</i><br>
You must use : <i>LogFormat="%virtualname %host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (<b>NCSA combined and mod_gzip format 1</b> with <b>Apache 1.x</b>):</u><br>
<i>62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 3904 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)" mod_gzip: 66pct.</i><br>
You must use : <i>LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot %other %gzipratio"</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (<b>NCSA combined and mod_gzip format 2</b> with <b>Apache 1.x</b>):</u><br>
<i>62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 3904 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)" mod_gzip: DECHUNK:OK In:11393 Out:3904:66pct.</i><br>
You must use : <i>LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot %other %other %gzipin %gzipout"</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (<b>NCSA combined and mod_deflate</b> with <b>Apache 2</b>):</u><br>
<i>62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 3904 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)" (45)</i><br>
You must use : <i>LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot %deflateratio"</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (<b>NCSA combined with 2 spaces between some fields</b> with <b>Zope</b>):</u><br>
<i>62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 3904 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)" (45)</i><br>
LogSeparator=" *"<br>
</i>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (<b>NCSA common CLF</b> log format):</u><br>
<i>62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 1234</i><br>
You must use : <i>LogFormat=4</i><br>
Note: Browsers, OS's, Keywords and Referers features are not available with a such format.<br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (With some <b>Squid</b> versions, after setting <i>emulate_http_log</i> to on):</u><br>
<i>200.135.30.181 - - [dd/mmm/yyyy:hh:mm:ss +0x00] "GET http://www.mydomain.com/page.html HTTP/1.0" 200 456 TCP_CLIENT_REFRESH_MISS:DIRECT</i><br>
You must use : <i>LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %other"</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (Some old <b>IIS</b> W3C log format):</u><br>
<i>yyyy-mm-dd hh:mm:ss 62.161.78.73 - GET /page.html 200 1234 HTTP/1.1 Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.html</i><br>
You must use : <i>LogFormat=2</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (Some <b>IIS</b> W3C log format with some <b>.net</b> servers):</u><br>
<i>yyyy-mm-dd hh:mm:ss GET /page.html - 62.161.78.73 - Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.html 200 1234 HTTP/1.1</i><br>
You must use : <i>LogFormat=2 (or LogFormat="%time2 %method %url %logname %host %other %ua %referer %code %bytesd %other")</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (Some <b>IIS 6+</b> W3C log format):</u><br>
<i>yyyy-mm-dd hh:mm:ss GET /page.html - 62.161.78.73 - Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.html 200 1234</i><br>
You must use : <i>LogFormat=2 (or LogFormat="date time cs-method cs-uri-stem cs-username c-ip cs-version cs(User-Agent) cs(Referer) sc-status sc-bytes")</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (Some <b>ISA</b> W3C log format):</u><br>
<i>62.161.78.73, anonymous, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1), N, 1/1/2001, 0:00:16, W3ReverseProxy, HCSERV2, -, www.host.be, 192.168.141.101, 80, 266, 406, 10042, http, TCP, GET, http://192.168.141.101/, text/html, Inet, 200, 0x42330010, -, -</i><br>
<i>LogFormat=2</i><br>
<i>LogSeparator=" "</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (With some <b>WebSite</b> versions):</u><br>
<i>yyyy-mm-dd hh:mm:ss 62.161.78.73 - 192.168.1.1 80 GET /page.html - 200 11205 0 0 HTTP/1.1 mydomain.com Mozilla/4.0+(compatible;+MSIE+5.5;+Windows+98) - http://www.from.com/from.html</i><br>
You must use : <i>LogFormat="%time2 %host %logname %other %other %method %url %other %code %bytesd %other %other %other %other %ua %other %referer"</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (<b>Webstar</b> native log format):</u><br>
<i>05/21/00 00:17:31 OK 200 212.242.30.6 Mozilla/4.0 (compatible; MSIE 5.0; Windows 98; DigExt) http://www.cover.dk/ "www.cover.dk" :Documentation:graphics:starninelogo.white.gif 1133</i><br>
You must use : <i>LogFormat=3</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (With some <b>Lotus Notes/Domino</b> versions):</u><br>
<i>62.161.78.73 - Name Surname Service [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 1234 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</i><br>
You must use : <i>LogFormat=6</i><br>
-</td></tr></table>
+
<hr>
<u>If your log records are EXACTLY like this (<b>Lotus Notes/Domino 6.x</b> log format):</u><br>
<i>62.161.78.73 - "Name Surname" Service [dd/mmm/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" 200 1234 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</i><br>
You must use : <i>LogFormat="%host %other %lognamequot %time1 %methodurl %code %bytesd %refererquot %uaquot"</i><br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (With <b>Oracle9iAS</b>):</u><br>
<i>62.161.78.73 - [dd/mmm/yyyy:hh:mm:ss +0x00] GET /page.html HTTP/1.1 200 1234 - "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</i><br>
Where separators are <tab> chars or several spaces,
You must use : <i>LogFormat="%host %logname %time1 %method %url %other %code %bytesd %referer %uaquot"</i>
and <i>LogSeparator="\s+"</i><br>
-</td></tr></table>
+
<hr>
<u>If you use a FTP server like <b>ProFTPd</b>:</u><br>
See <a href="#FTP">FAQ-COM090</a>.<br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If you want to analyze a mail log file (<b>Postfix</b>, <b>Sendmail</b>, <b>QMail</b>, <b>MDaemon</b>, <b>Exchange</b>):</u><br>
See <a href="#MAIL">FAQ-COM100</a>.<br>
-</td></tr></table>
+
<hr>
<u>If you use a Media Server (<b>Realmedia</b>, <b>Windows Media Server</b>):</u><br>
See <a href="#MEDIASERVER">FAQ-COM110</a>.<br>
<hr>
-<table bgcolor=#F4F4F4 width="100%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<u>If your log records are EXACTLY like this (With some providers):</u><br>
<i>62.161.78.73 - - [dd/Month/yyyy:hh:mm:ss +0x00] "GET /page.html HTTP/1.1" "-" 200 1234</i><br>
You must use : <i>LogFormat="%host %other %logname %time1 %methodurl %other %code %bytesd"</i><br>
Note: Browsers, OS's, Keywords and Referers features are not available with a such format.<br>
-</td></tr></table>
+
<hr>
<u>There is a lot of other possible log formats.</u><br>
You must use a personalized log format LogFormat ="..." as described in config file to
support other various log formats.<br>
-<br>
+<br><br>
<a name="ROTATE"></a><br>
<b><u>FAQ-COM120 : HOW TO ROTATE MY LOGS WITHOUT LOOSING DATA</u></b><br>
The use of this tool is not an AWStats related problem, so please take a look at your Windows manual.
Warning, if you use <i>"awstats.pl -config=mysite -update"</i> in your scheduled task, you might
experience problem of failing task. Try this instead<br>
-<i>"C:\WINNT\system32\CMD.EXE /C C:\[awstats_path]\awstats.pl -config=mysite -update"</i><br>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+"C:\WINNT\system32\CMD.EXE /C C:\[awstats_path]\awstats.pl -config=mysite -update"
+</td></tr></table>
or<br>
-<i>"C:\[perl_path]\perl.exe C:\[awstats_path]\awstats.pl -config=mysite -update"</i><br>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+"C:\[perl_path]\perl.exe C:\[awstats_path]\awstats.pl -config=mysite -update"
+</td></tr></table>
A lot of other open source schedulers are often better (otherwise there is also good sharewares or freewares).<br>
<br>
<u>With unix-like operating systems</u>, you can use the "<b>crontab</b>".<br>
This is examples of lines you can add in the cron file (see your unix reference manual for cron) :<br>
To run update every day at 03:50, use :<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
50 3 * * * /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=mysite -update >/dev/null<br>
</td></tr></table>
To run update every hour, use :<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
0 * * * * /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=mysite -update >/dev/null<br>
</td></tr></table>
<br>
includes in its parameters, the screen size resolution and other informations about browser capabilities.<br>
<br>
This is the code you must add (at bottom of your home page for example) :<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<script language="javascript" type="text/javascript" src="/js/awstats_misc_tracker.js" ></script><br>
<noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height="0" width="0" border="0" style="display: none"></noscript><br>
</td></tr></table>
a js directory stored in your web root.<br>
Once this is done, load your home page with your browser and go to check that inside your log file
if you can see a line that looks like that:<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
-123.123.123.123 - - [24/Apr/2005:16:09:38 +0200] "GET /js/awstats_misc_tracker.js?screen=800x600&win=724x517&cdi=32&java=true&shk=n&fla=y&rp=n&mov=n&wma=y&pdf=y&uid=awsuser_id123&sid=awssession_id123 HTTP/1.1" 200 6237 "http://therefererwebsite.com/index.php" "Mozilla/5.0 (Linux) Gecko/20050414 Firefox/1.0.3"
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+123.123.123.123 - - [24/Apr/2005:16:09:38 +0200] "GET /js/awstats_misc_tracker.js?screen=800x600&win=724x517&...&sid=awssession_id123 HTTP/1.1" 200 6237 "http://therefererwebsite.com/index.php" "Mozilla/5.0 (Linux) Gecko/20050414 Firefox/1.0.3"
</td></tr></table>
<br>
If yes, you can then run the AWStats update process. Screen sizes information will be analyzed. All you have to do
now is to edit your config file to tell AWStats to add the report on html output. For this, change
the <a href="awstats_config.html#Show">ShowMiscStats</a> parameter.<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
ShowMiscStats=anjdfrqwp
</td></tr></table>
<br>
So this means this way of working might never be changed, so another chance is to use the AWStats plugin 'timezone'.
Warning, this plugin need the perl module Time::Local and it reduces seriously AWStats speed.<br>
To enable the plugin, uncomment the following line in your config file.<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>LoadPlugin="timezone TZ"</i><br>
</td></tr></table>
where TZ is value of your signed timezone (+2 for Paris, -8 for ...)<br>
<i>LogFile=mylog*.log</i><br>
However, with such a syntax, AWStats can't know in wich order processing log files (wich log file is the first, next or last). So
to work like this you must use the following syntax:<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>LogFile="/pathto/logresolvemerge.pl mylog*.log |"</i><br>
</td></tr></table>
<a href="awstats_tools.html#logresolvemerge">Logresolvemerge</a> is a tool provided with
the <i>-LogFile</i> command line option to overwrite <a href="awstats_config.html#LogFile">LogFile</a> value.<br>
As an other solution, if you miss disk space, or to save time, you can ask <a href="awstats_tools.html#logresolvemerge">logresolvemerge</a>
to merge log files on the fly during the AWStats update process. For this, you can use the following syntax in your AWStats config file:<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
<i>LogFile="/pathto/logresolvemerge.pl file*.log |"</i><br>
</td></tr></table>
See also <a href="awstats_faq.html#MULTILOG">FAQ-COM360</a> for explanation on logresolvemerge use.<br>
tell Apache where is your external Perl interpreter.<br>
<u>For this, you have 2 solutions:</u><br>
1) Add the following directive in your Apache <b>httpd.conf</b> config (or remove the # to uncomment it if line is already available)<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
ScriptInterpreterSource registry<br>
</td></tr></table>
Then restart Apache. This will tell Apache to look into the registry to find the program associated to .pl extension.<br>
<br>
<u>So if your OS is Unix/Linux</u><br>
<i>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
grep -vE '^[0-9]{6}00' oldhistoryfile > newhistoryfile<br>
mv newhistoryfile oldhistoryfile<br>
+</td></tr></table>
</i>
And then run the migrate process again on the file.<br>
<br>
all worms signatures. So if you still have rubish hits, you can modify the worms.pm file yourself or
edit your config file to add in the <a href="awstats_config.html#SkipFiles">SkipFiles</a> parameter some
values to discard the not required records, using a regex syntax like example :<br>
-<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr><td>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
SkipFiles="REGEX[^\/default\.ida] REGEX[\/winnt\/system32\/cmd\.exe]"<br>
</td></tr></table>
<br>
<html>
<head>
<meta name="description" content="AWStats Documentation - Setup page">
-<meta name="keywords" content="awstats, awstat, setup, config, install">
+ <meta name="keywords"\r
+ content="awstats, awstat, setup, config, install">\r
<meta name="robots" content="index,follow">
<meta name="title" content="AWStats Documentation - Setup page">
<title>AWStats Documentation - Setup page</title>
<link rel="stylesheet" href="styles.css" type="text/css">
<!-- $Revision$ - $Author$ - $Date$ -->
</head>
-
-<body topmargin=10 leftmargin=5>
-
-
-<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
-
-<!-- Large -->
-<tr style="font: 10pt arial,helvetica,verdana">
-<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,sans-serif" color=#EEEEFF><b>AWStats logfile analyzer 6.4 Documentation</b></font><br>
+<body topmargin="10" leftmargin="5">\r
+<table\r
+ style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"\r
+ bgcolor="#ffffff" border="0" cellpadding="0" cellspacing="0"\r
+ width="100%">\r
+<!-- Large --> <tbody>\r
+ <tr\r
+ style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;">\r
+ <td align="center" bgcolor="#9999cc"><a href="/"><img\r
+ src="images/awstats_logo4.png" border="0"></a></td>\r
+ <td align="center" bgcolor="#9999cc"> <br>\r
+ <font\r
+ style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 16pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"\r
+ color="#eeeeff"><b>AWStats logfile analyzer 6.5 Documentation</b></font><br>\r
<br>
</td>
-<td bgcolor=#9999cc align=center>
-
-</td>
+ <td align="center" bgcolor="#9999cc"> </td>\r
</tr>
-
+ </tbody>\r
</table>
-
-
-<br><br><H1 style="font: 26px arial,helvetica,sans-serif">Install, Setup and Use AWStats</H1>
-
-AWStats common use is made in 3 phases:<br>
+<br>\r
+<br>\r
+<h1\r
+ style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 26px; line-height: normal; font-size-adjust: none; font-stretch: normal;">AWStats\r
+Installation, Configuration and Reporting</h1>\r
+There are 3 steps to begin using AWStats:<br>\r
<ul>
-<li><a href="#INSTALL">Setup: Install and Setup</a><br>
-<li><a href="#BUILD_UPDATE">Statistics update: Building/Updating statistics database</a><br>
-<li><a href="#READ">Reports build: Building and reading reports</a><br>
+ <li><a href="#INSTALL">I. Setup: Installation and configuration</a><br>\r
+ </li>\r
+ <li><a href="#BUILD_UPDATE">II. Process logs: Building/updating\r
+statistics database</a><br>\r
+ </li>\r
+ <li><a href="#READ">III. Run Reports: Building and reading reports</a><br>\r
+ </li>\r
</ul>
<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,sans-serif color: #606060"><u>Setup : Install and Setup with awstats_configure.pl</u></H2></a>
-<br>
-<a name="INSTALLAPACHE"><b>A) Setup with Apache or compatible server (on Unix/Linux, Windows, MacOS...)</b></a><br>
<br>
-<font style="color: #111155"><b>* Step 1</b>:</font><br>
-<br>
-(if you use a package provided with a Linux distribution or Windows installer, action done in step 1
-might have already be done, if you don't know, you can run this step again)<br>
-<br>
-After downloading and extracting the AWStats package, you should run the awstats_configure.pl script to do
+<a name="INSTALL">\r
+<h2 style=""><u>I. Setup: Installation and configuration using\r
+awstats_configure.pl</u></h2>\r
+</a><br>\r
+<a name="INSTALLAPACHE"><b>A) Setup for an Apache or compatible web\r
+server (on Unix/Linux, Windows, MacOS...)</b></a><br>\r
+<br>\r
+<font style="color: rgb(17, 17, 85);"><b>* Step 1</b>:</font><br>\r
+<br>\r
+(if you use a package provided with a Linux distribution or Windows\r
+installer, step 1\r
+might have already been done; if you don't know, you can run this step\r
+again)<br>\r
+<br>
+After downloading and extracting the AWStats package, you should run\r
+the awstats_configure.pl script to do\r
several setup actions.
-You will find it in the AWStats <b>tools</b> directory (If using the Windows installer, the script is
+You will find it in the AWStats <b>tools</b> directory (If using the\r
+Windows installer, the script is\r
automatically launched):<br>
-<b><i>perl awstats_configure.pl</i></b><br>
-
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+perl awstats_configure.pl
+</td></tr></table>
+<br>
<ul>
-
-<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>
+ <u>This is what the script does/asks (you can do all these steps\r
+manually instead of running awstats_configure.pl if you prefer):</u><br>\r
<br>
-
-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.
+A) awstats_configure.pl tries to determine your current log format from\r
+your Apache web server\r
+configuration file httpd.conf (it asks for the path if not found).\r
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, 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>
+suggest changing it to the <b>NCSA combined/XLF/ELF</b> format (you\r
+can use your own custom log\r
+format but this predefined log format is often the best choice and\r
+makes setup easier).<br>\r
+If you answer yes, awstats_configure.pl will modify your <b>httpd.conf</b>,\r
+changing the\r
+following directive:<br>\r
+ <i>from<br>\r
+CustomLog /yourlogpath/yourlogfile common</i><br>\r
+to<br>\r
<i>CustomLog /yourlogpath/yourlogfile combined</i><br>
<br>
-See your Apache manual for more information on this directive.<br>
-To be sure the log format change is effective, later you can stop Apache, remove all old
-log files, restart Apache and go to your homepage. This is an example of records you
-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, 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># Directives to add to your Apache conf file to allow use of AWStats as a CGI.
-<br># Note that path "/usr/local/awstats/" must reflect your AWStats install path.
-<br>#
-<br>Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
-<br>Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
-<br>Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
-<br>ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"
-<br>#
-<br># This is to permit URL access to scripts/files in AWStats directory.
-<br>#
-<br><Directory "/usr/local/awstats/wwwroot">
-<br> Options None
-<br> AllowOverride None
-<br> Order allow,deny
-<br> Allow from all
-<br></Directory>
-</i>
-<br>
-
-<br>
-C) awstats_configure.pl restart Apache to apply the changes made in A and B (if changes were made).<br>
-<br>
-
-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 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>
+See the Apache manual for more information on this directive (possibly\r
+installed on your server as www.mysite.com/manual).<br>\r
+ <br>\r
+B) awstats_configure.pl will then add, if not already present, the\r
+following directives to your Apache configuration file\r
+(note that the "/usr/local/awstats/wwwroot" path might differ according\r
+to your distribution or OS:<br>\r
+ <i> <br>\r
+# <br>\r
+# Directives to add to your Apache conf file to allow use of AWStats as\r
+a CGI. <br>\r
+# Note that path "/usr/local/awstats/" must reflect your AWStats\r
+Installation path. <br>\r
+# <br>\r
+Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/" <br>\r
+Alias /awstatscss "/usr/local/awstats/wwwroot/css/" <br>\r
+Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/" <br>\r
+ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/" <br>\r
+# <br>\r
+# This is to permit URL access to scripts/files in AWStats directory. <br>\r
+# <br>\r
+<Directory "/usr/local/awstats/wwwroot"> <br>\r
+Options None <br>\r
+AllowOverride None <br>\r
+Order allow,deny <br>\r
+Allow from all <br>\r
+</Directory> </i><br>\r
+ <br>\r
+C) if changes were made as indicated in parts A and B,\r
+awstats_configure.pl restarts Apache to apply the changes. To be\r
+sure the log format change is effective, go to your homepage. This is\r
+an example of the type of records you should see inserted in your new\r
+log file after Apache\r
+was restarted:<br>\r
+ <br>\r
+62.161.78.75 - - [dd/mmm/yyyy:hh:mm:ss +0000] "GET / HTTP/1.1" 200 1234\r
+"http://www.from.com/from.html" "Mozilla/4.0 (compatible; MSIE 5.01;\r
+Windows NT 5.0)"<br>\r
+ <br>\r
+D) awstats_configure.pl will ask you for a name for the configuration\r
+profile file. Enter an appropriate name such as that of your\r
+web server or the virtual domain to be analyzed, i.e. <b\r
+ style="font-style: italic;">mysite</b>.<br>\r
+ <br>\r
+awstats_configure.pl will create a new file called <b>awstats.<span\r
+ style="font-style: italic;">mysite</span>.conf</b>\r
+by copying the template file <b>awstats.model.conf</b>.\r
+The new file location is:<br>\r
- 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>
+- For Mac OS X, Windows and other operating systems: the same directory\r
+as awstats.pl\r
+(cgi-bin).<br>\r
<br>
E) awstats_configure.pl ends.<br>
<br>
</ul>
-
-<font style="color: #111155"><b>* Step 2</b>:</font><br>
-<br>
-Once a config file has been automatically created (by awstats_configure.pl, by your 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>
-This is for example the parameters you should check seriously :<br>
-- Check/Change <a href="awstats_config.html#LogFile">LogFile</a> value with full path of your server log file (You
-can also use a relative path from your awstats.pl directory, but full path avoid errors).<br>
-- Check/Change <a href="awstats_config.html#LogType">LogType</a> value with "W" for analyzing
-web server log files, "S" for a streaming server log file, "M" for mail log files, "F" for ftp log files.<br>
-- Check if <a href="awstats_config.html#LogFormat">LogFormat</a> has the value "1" (it means "NCSA apache combined/ELF/XLF log format")
-or use a personalized log format if you don't use combined log format.<br>
-- Edit <a href="awstats_config.html#SiteDomain">SiteDomain</a> parameter with the main domain name or the intranet
-web server name used to reach the web site to analyze (Example: www.mydomain.com). If you have several
-possible name for same site, use the main domain name and add list of others in <a href="awstats_config.html#HostAlias">HostAlias</a> parameter.<br>
-- You can also change other parameters if you want. Full list is available in <a href="awstats_config.html">Configurations/Directives options</a> page.<br>
-<br>
-
-Install and Setup is finished. You can jump to the <a href="#BUILD_UPDATE">Building/Updating statistics database</a> section.<br>
-<br>
-<br>
-
-
-<br>
-<a name="INSTALLIIS"><b>B) Setup with IIS server</b></a><br>
-<br>
-<font style="color: #111155"><b>* Step 1</b>:</font><br>
-<br>
-Configure IIS to log in <b>"Extended W3C log format"</b> (You can still use
-your own log format but setup is easier if made like suggested). So, for
-this, start the IIS Snap-in, select the web site and look at its
-Properties. Choose W3C Extended Log Format, then Properties, then the
-Tab Extended Properties and uncheck everything under Extended Properties.
-Once they are all unchecked, check all following fields:<br>
-<i>
-date<br>
-time<br>
-c-ip<br>
-cs-username<br>
-cs-method<br>
-cs-uri-stem<br>
-cs-uri-query<br>
-sc-status<br>
-sc-bytes<br>
-cs-version<br>
-cs(User-Agent)<br>
-cs(Referer)<br>
-</i>
-To be sure the log format change is effective, you must stop IIS, remove all old log files, restart IIS and go to
-your homepage. This is an example of records you should get then in the new log file:<br>
-<i>2000-07-19 14:14:14 62.161.78.73 - GET / 200 1234 HTTP/1.1 Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.htm</i><br>
+<font style="color: rgb(17, 17, 85);"><b>* Step 2</b>:</font><br>\r
+<br>
+Once a configuration file has been created (by\r
+awstats_configure.pl, by your package\r
+installer or just by a manual copy of awstats.model.conf), it's\r
+important to verify that the "MAIN PARAMETERS"\r
+match your needs. Open awstats.<span\r
+ style="font-style: italic; font-weight: bold;">mysite</span>.conf in\r
+your favorite text editor (i.e. notepad.exe, vi, gedit, etc) -\r
+don´t use a word processor - and make changes as required.<br>\r
+<br>\r
+Particular attention should be given to these parameters:<br>\r
+- Verify the <a href="awstats_config.html#LogFile">LogFile</a>\r
+value. It should be the full path of your server log file (You\r
+can also use a relative path from your awstats.pl directory, but a full\r
+path avoids errors).<br>\r
+- Verify the <a href="awstats_config.html#LogType">LogType</a>\r
+value. It should be "W" for analyzing\r
+web log files.<br>\r
+- Check if <a href="awstats_config.html#LogFormat">LogFormat</a> is\r
+set to "1" (for "NCSA apache combined/ELF/XLF log format")\r
+or use a custom log format if you don't use the combined log format.<br>\r
+- Set the <a href="awstats_config.html#SiteDomain">SiteDomain</a>\r
+parameter to the main domain name or the intranet web server name\r
+used to reach the web site to analyze (Example: www.mysite.com). If\r
+you have several\r
+possible names for same site, use the main domain name and add the\r
+others to the list in the <a href="awstats_config.html#HostAlias">HostAlias</a>\r
+parameter.<br>\r
+- You can also change other parameters if you want. The full list is\r
+described in <a href="awstats_config.html">Configurations/Directives\r
+options</a> page.<br>\r
+<br>\r
+Installation and configuration is finished. You can jump to the <a\r
+ href="#BUILD_UPDATE">Process logs: Building/updating statistics\r
+database</a> section.<br>\r
<br>
-
-<font style="color: #111155"><b>* Step 2</b>:</font><br>
-<br>
-Copy the contents of the provided cgi-bin folder from your hard drive to your server's cgi-bin
-directory (this includes <b>awstats.pl</b>, <b>awstats.model.conf</b>, and the <b>lang</b>, <b>lib</b> and <b>plugins</b> sub-directories).<br>
<br>
-
-<font style="color: #111155"><b>* Step 3</b>:</font><br>
<br>
-Move AWStats <b>icon sub-directories</b> and its content into a directory readable by your
-web server, for example C:\yourwwwroot\icon.<br>
-<br>
-
-<font style="color: #111155"><b>* Step 4</b>:</font><br>
-<br>
-Create a config file by copying <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 must be stored in<br>
-- Same directory than awstats.pl (so cgi-bin)<br>
-<br>
-
-<font style="color: #111155"><b>* Step 5</b>:</font><br>
-<br>
-Edit this new config file with your own setup :<br>
-- Change <a href="awstats_config.html#LogFile">LogFile</a> value with full path of your web server log file (You
-can also use a relative path from your awstats.pl directory).<br>
-- Change <a href="awstats_config.html#LogType">LogType</a> value with "W" for analyzing
-web server log files, "S" for a streaming server log file, "M" for mail log files, "F" for ftp log files, "O" otherwise.<br>
-- Change <a href="awstats_config.html#LogFormat">LogFormat</a> to a value with same field's name defined in step 1:<br><i>
-LogFormat="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)"</i><br>
-- Change <a href="awstats_config.html#DirIcons">DirIcons</a> parameter to reflect relative path of icon directory.<br>
-- Edit <a href="awstats_config.html#SiteDomain">SiteDomain</a> parameter with the main domain name or the intranet
-web server name used to reach the web site to analyze (Example: www.mydomain.com).<br>
-- Set <a href="awstats_config.html#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a> parameter to 1 if you don't have command line access and have only cgi access.<br>
-- You can change other parameters if you want.<br>
-<br>
-Install and Setup is finished. You can jump to the <a href="#BUILD_UPDATE">Building/Updating statistics database</a> section.<br>
-<br>
-<br>
-
-<br>
-<b>C) Setup with other web servers</b><br>
-<br>
-Setup process is similar to setup for Apache or IIS.<br>
-Use <a href="awstats_config.html#LogFormat">LogFormat</a> to value "3" if you have WebStar native log format, use
-a personalized <a href="awstats_config.html#LogFormat">LogFormat</a> if your log format is other.<br>
-<br>
-
-
-<br>
-<br>
-<a name="BUILD_UPDATE"><H2 style="font: 22px arial,helvetica,sans-serif color: #606060"><u>Statistics update: Building/Updating statistics database</u></H2></a>
-
-<br>
-<font style="color: #111155"><b>* Step 1</b>:</font><br>
-<br>
-The first analyze/update of statistics should be made the first time manually from the command line since first time,
-process may be long and it's easier to solve problems (if you don't have Command Line access, just go to Step 2). The
-AWStats update command line is:<br>
-<b><i>awstats.pl -config=myvirtualhostname -update</i></b><br>
-<br>
-AWStats will read the config file awstats.myvirtualhostname.conf (or if not found, awstats.conf)
-and create/update its database with all summary information issued from analyzed log file.<br>
-AWStats database files are saved in directory defined in config file by <a href="awstats_config.html#DirData">DirData</a> parameter.<br>
-When update is finished, you should get on screen a result like this:<br>
-<br><i>
-Update for config "/etc/awstats/awstats.myvirtualhostname.conf"<br>
+<a name="INSTALLIIS"><b>B) Setup for Microsoft's IIS server</b></a><br>\r
+<br>
+<font style="color: rgb(17, 17, 85);"><b>* Step 1</b>:</font><br>\r
+<br>
+Configure IIS to log in the <b>"Extended W3C log format"</b> (You can\r
+still use\r
+your own custom log format but setup is easier if you use the standard\r
+extended format). To do so, start the IIS management console snap-in,\r
+select the\r
+appropriate web site and open its\r
+<span style="font-weight: bold;">Properties</span>. Choose "<span\r
+ style="font-weight: bold;">W3C Extended Log Format</span>", then <span\r
+ style="font-weight: bold;">Properties</span>, then the\r
+Tab "<span style="font-weight: bold;">Extended Properties</span>" and\r
+uncheck everything under Extended\r
+Properties.\r
+Once they are all cleared, check just the following fields:<br>\r
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
+date<br>\r
+time<br>\r
+c-ip<br>\r
+cs-username<br>\r
+cs-method<br>\r
+cs-uri-stem<br>\r
+cs-uri-query<br>\r
+sc-status<br>\r
+sc-bytes<br>\r
+cs-version<br>\r
+cs(User-Agent)<br>\r
+cs(Referer)<br>\r
+</td></tr></table>
+<br>\r
+To be sure the log format change is effective, you must stop IIS,\r
+backup (if desired) and remove all old log files, restart IIS and go to\r
+your homepage. This is an example of the type of records you should\r
+find in the\r
+new log file:<br>\r
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
+2000-07-19 14:14:14 62.161.78.73 - GET / 200 1234 HTTP/1.1\r
+Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0)\r
+http://www.from.com/from.htm\r
+</td></tr></table>
+<br>
+
+<font style="color: rgb(17, 17, 85);"><b>* Step 2</b>:</font><br>\r
+<br>
+Copy the contents of the AWStats provided cgi-bin folder from where\r
+your AWStats package put it on your local hard\r
+drive\r
+to your server's cgi-bin\r
+directory (this includes <b>awstats.pl</b>, <b>awstats.model.conf</b>,\r
+and the <b>lang</b>, <b>lib</b> and <b>plugins</b> sub-directories).<br>\r
+<br>\r
+<font style="color: rgb(17, 17, 85);"><b>* Step 3</b>:</font><br>\r
+<br>\r
+Move AWStats <b>icon sub-directories</b> and its content into a\r
+directory readable by your\r
+web server, for example C:\yourwwwroot\icon.<br>\r
+<br>\r
+<font style="color: rgb(17, 17, 85);"><b>* Step 4</b>:</font><br>\r
+<br>\r
+Create a configuration file by copying <b>awstats.model.conf</b> to a\r
+new file named <b>awstats.<span style="font-style: italic;">mysite</span>.conf</b>\r
+where "<span style="font-style: italic;">mysite</span>" is a\r
+value of your choice but usually is the domain or virtual host name.\r
+This new file must be saved in the same directory as awstats.pl (i.e.\r
+cgi-bin).<br>\r
+<br>\r
+<font style="color: rgb(17, 17, 85);"><b>* Step 5</b>:</font><br>\r
+<br>\r
+Edit your new <b>awstats.<span style="font-style: italic;">mysite</span>.conf</b>\r
+file to match your specific environment:<br>\r
+- Change the <a href="awstats_config.html#LogFile">LogFile</a> value\r
+to the\r
+full path of your web server log file (You\r
+can also use a relative path from your awstats.pl (cgi-bin) directory).<br>\r
+- Change the <a href="awstats_config.html#LogType">LogType</a> value\r
+to\r
+"W" for analyzing\r
+web log files.<br>\r
+- Change the <a href="awstats_config.html#LogFormat">LogFormat</a> to\r
+2 if you are using the <b>"Extended W3C log format"</b> described in\r
+step 1; in the case of a custom format, list the IIS fields\r
+being logged, for example:<br>\r
+<i>LogFormat="date time c-ip cs-username cs-method cs-uri-stem\r
+cs-uri-query sc-status sc-bytes cs-version cs(User-Agent) cs(Referer)"</i><br>\r
+- Change the <a href="awstats_config.html#DirIcons">DirIcons</a>\r
+parameter\r
+to reflect relative path of icon directory.<br>\r
+- Set the <a href="awstats_config.html#SiteDomain">SiteDomain</a>\r
+parameter to the main domain name or the intranet\r
+web server name used to reach the web site being analyzed (Example:\r
+www.mydomain.com).<br>\r
+- Set the <a href="awstats_config.html#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a>\r
+parameter to 1 if you don't have command line access and have only cgi\r
+access.<br>\r
+- Review and change other parameters if appropriate.<br>\r
+<br>\r
+Installation and configuration is finished. You can jump to the <a\r
+ href="#BUILD_UPDATE">Process logs: Building/Updating statistics\r
+database</a> section.<br>\r
+<br>\r
+<b>C) Setup for other web servers</b><br>\r
+<br>\r
+The setup process is similar to the setup for Apache or IIS.<br>\r
+Use <a href="awstats_config.html#LogFormat">LogFormat</a> to value "3"\r
+if you have WebStar native log format, use\r
+a personalized <a href="awstats_config.html#LogFormat">LogFormat</a>\r
+if your log format is other.<br>\r
+<br>\r
+<b>D) Setup for other Internet servers, i.e. FTP, Mail, Streaming media</b><br>\r
+<br>\r
+The setup process for other file formats is described in the relevant\r
+FAQ topics: \r
+<a href="awstats_faq.html#FTP">FAQ-COM090: FTP</a> \r
+<a href="awstats_faq.html#MAIL">FAQ-COM100: Mail</a> and <a\r
+ href="awstats_faq.html#MEDIASERVER">FAQ-COM110: Streaming media</a>.<br>\r
+<br>\r
+
+<br>
+<a name="BUILD_UPDATE">\r
+<h2 style=""><u>II. Process logs: Building/updating statistics database</u></h2>\r
+</a><br>\r
+<font style="color: rgb(17, 17, 85);"><b>* Update from command line (recommanded)</b>:</font><br>\r
+<br>\r
+The first log analysis should be done\r
+manually from the command line since the\r
+process may be long and it's easier to solve problems when you can see\r
+the\r
+command output (if you don't\r
+have Command Line access, skip to Step 2). The\r
+AWStats create (and update) statistics database command is:<br>\r
+<br>\r
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+perl awstats.pl -config=mysite -update
+</td></tr></table>\r
+<br>\r
+where <span style="font-style: italic;">mysite</span> must\r
+be substituted with the domain/virtual host name you selected earlier\r
+during AWStats configuration.<br>\r
+<br>\r
+AWStats will read the configuration file awstats.mysite.conf\r
+(or if\r
+not found, awstats.conf)\r
+and create/update its database with all summary information issued from\r
+analyzed log file.<br>\r
+<br>\r
+AWStats statistics database files are saved in directory defined by the\r
+<a href="awstats_config.html#DirData">DirData</a> parameter in\r
+configuration file.<br>\r
+When the create/update is finished, you should see a similar result on\r
+your screen:<br>\r
+<br>\r
+<table width="95%" border=1 cellpadding=0 cellspacing=0 bgcolor=#F4F4F4 class=CFAQ><tr class=CFAQ><td class=CFAQ>
+Update for config "/etc/awstats/awstats.mysite.conf"<br>\r
With data in log file "/pathtoyourlog/yourlog.log"...<br>
Phase 1 : First bypass old records, searching new record...<br>
Searching new records from beginning of log file...<br>
-Phase 2 : Now process new records (Flush history on disk after 20000 hosts)...<br>
+Phase 2 : Now process new records (Flush history on disk after 20000\r
+hosts)...<br>\r
Jumped lines in file: 0<br>
Parsed lines in file: 225730<br>
Found 122 dropped records,<br>
Found 87 corrupted records,<br>
Found 0 old records,<br>
- Found 225521 new qualifed records.<br>
-</i><br>
-<b>Dropped records</b> are records discarded because they were not "user HTTP requests" or requests were not qualified
-by AWStats filters (See <a href="awstats_config.html#SkipHosts">SkipHosts</a>, <a href="awstats_config.html#SkipUserAgents">SkipUserAgents</a>,
-<a href="awstats_config.html#SkipFiles">SkipFiles</a>, <a href="awstats_config.html#OnlyHosts">OnlyHosts</a>,
-<a href="awstats_config.html#OnlyUserAgents">OnlyUserAgents</a> and <a href="awstats_config.html#OnlyFiles">OnlyFiles</a> parameters).
-If you want to see which lines were dropped, you can add the <b>-showdropped</b> option on command line.<br>
-<b>Corrupted records</b> are records that does not match log format defined by "LogFormat" parameter in AWStats config/domain file.
-With all webservers you can experience a little bit corrupted records (<5%) even when everythings work correctly.
-This can be the result of several reasons: Web server internal bugs, bad requests made by buggy browsers, web server brutal stop...<br>
-If all your lines are corrupted and <a href="awstats_config.html#LogFormat">LogFormat</a> parameter in AWStats config/domain file is
-correct, it may be the log format setup in your web server that is wrong. Don't forget that
-your <a href="awstats_config.html#OnlyFiles">LogFormat</a> parameter in AWStats config/domain file MUST match
-the log file format you analyze.<br>
-If you want to see which lines are corrupted, you can add the <b>-showcorrupted</b> option on command line.<br>
-<b>Old records</b> are simply records that were already processed by a previous update process.
-You understood that it's not necessary to purge your log file after each update process even
-if it's highly recommended to do it as often as possible.<br>
-<b>New records</b> are records in your log file that were successfully used to build/update statistics.<br>
-<br>
-Note : A log analysis process might be slow (one second for each 4500 lines of your
-logfile with Athlon 1Ghz, plus DNS resolution time for each different IP
-address in your logfile if <a href="awstats_config.html#DNSLookup">DNSLookup</a> is set to 1 and not already done in your log file).<br>
-See <a href="awstats_benchmark.html">Benchmark page</a> for more accurate information.<br>
-<br>
-
-<font style="color: #111155"><b>* Step 2</b>:</font><br>
-<br>
-AWStats statistics can also be updated from a browser, to provide real-time statistics, by clicking
-the "Update now" link that appears when AWStats is used as a CGI (Next section '<a href="#READ">Reports build: Building and reading reports</a>
-dynamically' gives you URL to use for that).<br>
+ Found 225521 new qualified records.<br>\r
+</td></tr></table>
+<br>
+<b>Dropped records</b> are records discarded because they were not\r
+"user HTTP requests" or were requests matching AWStats filters (See the\r
+<a href="awstats_config.html#SkipHosts">SkipHosts</a>,\r
+<a href="awstats_config.html#SkipUserAgents">SkipUserAgents</a>,\r
+<a href="awstats_config.html#SkipFiles">SkipFiles</a>, <a\r
+ href="awstats_config.html#OnlyHosts">OnlyHosts</a>,\r
+<a href="awstats_config.html#OnlyUserAgents">OnlyUserAgents</a> and <a\r
+ href="awstats_config.html#OnlyFiles">OnlyFiles</a> parameters).\r
+If you want to see which lines were dropped, you can add the <b>-showdropped</b>\r
+option on the command line.<br>\r
+<br>\r
+<b>Corrupted records</b> are records that does not match log format\r
+defined by "LogFormat" parameter in AWStats configuration file.\r
+All web servers will typically have a few corrupted records\r
+(<5%) even when everything works correctly.\r
+This can result for several reasons: 1) Web server internal bugs,\r
+2) bad requests made by buggy browsers, 3) a dirty web server shutdown,\r
+such as unplugging the server... <br>\r
+<br>\r
+If all your lines are corrupted and the <a\r
+ href="awstats_config.html#LogFormat">LogFormat</a> parameter in\r
+AWStats configuration file is\r
+correct, there may be a setup problem with your web server log format.\r
+Don't forget that\r
+your <a href="awstats_config.html#OnlyFiles">LogFormat</a> parameter\r
+in the AWStats configuration file MUST match\r
+the log file format you analyze. If you want to see which lines\r
+are corrupted, you can add the <b>-showcorrupted</b>\r
+option on the command line.<br>\r
+<br>\r
+<b>Old records</b> are simply records that were already processed by a\r
+previous update session.\r
+Although it is not necessary to purge your log file after\r
+each update process, it is highly recommended that you do so as often\r
+as possible.<br>\r
+<br>\r
+<b>New records</b> are records in your log file that were successfully\r
+used to build/update the statistics database.<br>\r
+<br>\r
+Note: A log analysis process might be slow (one second for each 4500\r
+lines of your\r
+logfile with an Athlon 1Ghz, plus DNS resolution time for each\r
+different\r
+IP\r
+address in your logfile if <a href="awstats_config.html#DNSLookup">DNSLookup</a>\r
+is set to 1 and not already done in your log file). See the <a\r
+ href="awstats_benchmark.html">Benchmarks page</a> for more detailed\r
+information.<br>\r
+<br>\r
+<!-- <span style="font-weight: bold;">Flush history </span>messages referer\r
+to ... (Flush history on disk after 20000 hosts). Flush history\r
+file on disk (unique url reach flush limit of 5000 -->\r
+\r
+<br>\r
+<font style="color: rgb(17, 17, 85);"><b>* Update from a browser</b>:</font><br>\r
+<br>\r
+AWStats statistics can also be updated from a browser, providing\r
+real-time statistics, by clicking\r
+the "Update now" link that appears when AWStats is used as a CGI (The\r
+URL is described in the next\r
+section '<a href="#READ">Run reports: Building and reading reports</a>').<br>\r
<br>
<b>Warning</b>!!<br>
-To enable this link, your parameter <a href="awstats_config.html#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a>
-must be set to 1 in your config file (Link is not enabled by default).<br>
-Then, using on-line update does not prevent you from running the update process from a scheduler
-frequently (command is same than update of first update process).<br>
+To enable this link, the configuration file parameter <a\r
+ href="awstats_config.html#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a>\r
+must be set to 1 (The link is not enabled by\r
+default).<br>\r
+Using the on-line update does not prevent you from running the update\r
+process automatically on a scheduled basis (the command is same as that\r
+of the first update process above).<br>\r
For this, you have two choices:<br>
-- Include the update command in your <b>logrotate</b> process. See <a href="awstats_faq.html#ROTATE">FAQ-COM120</a> for this.<br>
-- Or add instructions in your <b>crontab</b> (Unix/Linux) or your <b>task scheduler</b> (for
-Windows), to launch frequently the Awstats update process. See <a href="awstats_faq.html#CRONTAB">FAQ-COM130</a> for this.<br><br>
-See AWStats <a href="awstats_benchmark.html">Benchmark page</a> for recommanded update/logrotate frequency.<br>
-<br>
-
-
-
-<br>
-<br><a name="READ"><H2 style="font: 22px arial,helvetica,sans-serif color: #606060"><u>Reports build: Building and reading reports</u></H2></a>
-
-<br>
-To see results of analyze, you have several solutions depending on your <a href="awstats_security.html">security policy</a>.<br>
-<br>
-
-* First solution is to build the main reports, in a static HTML page, from the command line,
-like this (jump to second solution if you have ONLY CGI access):<br>
-<b><i>perl awstats.pl -config=myvirtualhostname -output -staticlinks > awstats.myvirtualhostname.html</i></b><br>
-<br>
-You can use all other output options (each of them give you another report).
-This is how to use all other possible output options(1) :<br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=alldomains -staticlinks > awstats.myvirtualhostname.alldomains.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=allhosts -staticlinks > awstats.myvirtualhostname.allhosts.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=lasthosts -staticlinks > awstats.myvirtualhostname.lasthosts.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=unknownip -staticlinks > awstats.myvirtualhostname.unknownip.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=alllogins -staticlinks > awstats.myvirtualhostname.alllogins.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=lastlogins -staticlinks > awstats.myvirtualhostname.lastlogins.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=allrobots -staticlinks > awstats.myvirtualhostname.allrobots.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=lastrobots -staticlinks > awstats.myvirtualhostname.lastrobots.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=urldetail -staticlinks > awstats.myvirtualhostname.urldetail.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=urlentry -staticlinks > awstats.myvirtualhostname.urlentry.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=urlexit -staticlinks > awstats.myvirtualhostname.urlexit.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=browserdetail -staticlinks > awstats.myvirtualhostname.browserdetail.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=osdetail -staticlinks > awstats.myvirtualhostname.osdetail.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=unknownbrowser -staticlinks > awstats.myvirtualhostname.unknownbrowser.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=unknownos -staticlinks > awstats.myvirtualhostname.unknownos.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=refererse -staticlinks > awstats.myvirtualhostname.refererse.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=refererpages -staticlinks > awstats.myvirtualhostname.refererpages.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=keyphrases -staticlinks > awstats.myvirtualhostname.keyphrases.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=keywords -staticlinks > awstats.myvirtualhostname.keywords.html</b></i><br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=errors404 -staticlinks > awstats.myvirtualhostname.errors404.html</b></i><br>
-<br>
-Note (1): If you prefer, you can use <a href="awstats_tools.html#awstats_buildstaticpages">awstats_buildstaticpages</a> tool to
-build all those pages in one command, or to generate PDF files.<br>
-<br>
-Note (2): You can also add a <i>filter</i> on the following output reports:<b>urldetail, urlentry, urlexit, allhosts, refererpages</b>.<br>
-<i>filter</i> can be a regexp on the full key you want awstats to present information about and you must use it after the output
+- Include the update command in your <b>logrotate</b> process. See <a\r
+ href="awstats_faq.html#ROTATE">FAQ-COM120</a> for details.<br>\r
+- Or add instructions in your <b>crontab</b> (Unix/Linux) or your <b>task\r
+scheduler</b> (Windows), to regularly launch the Awstats update\r
+process. See <a href="awstats_faq.html#CRONTAB">FAQ-COM130</a> for\r
+details.<br>\r
+<br>\r
+See the AWStats <a href="awstats_benchmark.html">Benchmarks page</a>\r
+for\r
+the recommended update/logrotate frequency.<br>\r
+<br>
+
+<br>
+<a name="READ">\r
+<h2 style=""><u>III. Run reports: Building and reading reports</u></h2>\r
+</a><br>\r
+To see the analysis results, you have several options depending on your\r
+<a href="awstats_security.html">security policy</a>.<br>\r
+<br>\r
+Note: you must have created a statistics data base for the analysis\r
+period by processing your\r
+log files before you try to create reports. See the previous\r
+section.<br>\r
+<br>\r
+1. The first option is to build the main reports, in a static HTML\r
+page,\r
+from the command line,\r
+using the following syntax (skip to the second option if you only have\r
+CGI access):<br>\r
+<br>\r
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+perl awstats.pl -config=mysite -output -staticlinks\r
+> awstats.mysite.html\r
+</td></tr></table>
+<br>\r
+where <span style="font-style: italic;">mysite</span> must\r
+be substituted with the domain/virtual host name you selected earlier\r
+during AWStats configuration.<br>\r
+<br>
+To create specific individual reports, specify the report name on the\r
+command\r
+line as follows¹:<br>\r
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+perl awstats.pl -config=mysite -output=alldomains\r
+-staticlinks > awstats.mysite.alldomains.html<br>\r
+perl awstats.pl -config=mysite -output=allhosts\r
+-staticlinks > awstats.mysite.allhosts.html<br>\r
+perl awstats.pl -config=mysite -output=lasthosts\r
+-staticlinks > awstats.mysite.lasthosts.html<br>\r
+perl awstats.pl -config=mysite -output=unknownip\r
+-staticlinks > awstats.mysite.unknownip.html<br>\r
+perl awstats.pl -config=mysite -output=alllogins\r
+-staticlinks > awstats.mysite.alllogins.html<br>\r
+perl awstats.pl -config=mysite -output=lastlogins\r
+-staticlinks > awstats.mysite.lastlogins.html<br>\r
+perl awstats.pl -config=mysite -output=allrobots\r
+-staticlinks > awstats.mysite.allrobots.html<br>\r
+perl awstats.pl -config=mysite -output=lastrobots\r
+-staticlinks > awstats.mysite.lastrobots.html<br>\r
+perl awstats.pl -config=mysite -output=urldetail\r
+-staticlinks > awstats.mysite.urldetail.html<br>\r
+perl awstats.pl -config=mysite -output=urlentry\r
+-staticlinks > awstats.mysite.urlentry.html<br>\r
+perl awstats.pl -config=mysite -output=urlexit\r
+-staticlinks > awstats.mysite.urlexit.html<br>\r
+perl awstats.pl -config=mysite -output=browserdetail\r
+-staticlinks > awstats.mysite.browserdetail.html<br>\r
+perl awstats.pl -config=mysite -output=osdetail\r
+-staticlinks > awstats.mysite.osdetail.html<br>\r
+perl awstats.pl -config=mysite -output=unknownbrowser\r
+-staticlinks > awstats.mysite.unknownbrowser.html<br>\r
+perl awstats.pl -config=mysite -output=unknownos\r
+-staticlinks > awstats.mysite.unknownos.html<br>\r
+perl awstats.pl -config=mysite -output=refererse\r
+-staticlinks > awstats.mysite.refererse.html<br>\r
+perl awstats.pl -config=mysite -output=refererpages\r
+-staticlinks > awstats.mysite.refererpages.html<br>\r
+perl awstats.pl -config=mysite -output=keyphrases\r
+-staticlinks > awstats.mysite.keyphrases.html<br>\r
+perl awstats.pl -config=mysite -output=keywords\r
+-staticlinks > awstats.mysite.keywords.html<br>\r
+perl awstats.pl -config=mysite -output=errors404\r
+-staticlinks > awstats.mysite.errors404.html<br>\r
+</td></tr></table>
+<br>\r
+¹If you prefer, you can use the <a\r
+ href="awstats_tools.html#awstats_buildstaticpages">awstats_buildstaticpages</a>\r
+tool to\r
+build all these pages in one command, or to generate PDF files.<br>\r
+<br>\r
+Notes:<br>\r
+<br>\r
+a) You can also add a <i>filter</i> on the following reports: <b>urldetail,\r
+urlentry, urlexit, allhosts, refererpages</b>. The <i>filter</i>\r
+can be a regexp (regular expression) on the full key you want AWStats\r
+to report on and is appended to the output\r
parameter separated by a ":".<br>
-For example, to output the urldetail report, with a filter on all pages that contains /news, you
+<br>\r
+For example, to output the urldetail report, including only pages which\r
+contain /news in their URL, you\r
can use the following command line:<br>
-<i><b>perl awstats.pl -config=myvirtualhostname -output=urldetail:</b>/news<b> -staticlinks > awstats.myvirtualhostname.urldetailwithfilter.html</b></i><br>
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+perl awstats.pl -config=mysite -output=urldetail:</b>/news<b>\r
+-staticlinks > awstats.mysite.urldetailwithfilter.html</b>\r
+</td></tr></table>
+<br>\r
+b) If you want to build a report for a particular month, add\r
+the options <i><b>-month=MM -year=YYYY</b></i> where MM is the month\r
+expressed as two digits, i.e. 03, and year is the four digit\r
+year. To build a\r
+report for a full year, add the options <i><b>-month=all -year=YYYY</b></i>\r
+(warning: this is often resource intensive and might use a lot of\r
+memory\r
+and CPU. Unix/Linux like operating systems might benefit from use\r
+of the "nice" command.)<br>\r
+<br>\r
+<br>\r
+2) The second option is to dynamically view your statistics from a\r
+browser. To do this, use the URL:<br>\r
+<table border=1 cellpadding=1 cellspacing=0 bgcolor=#F4F4F4 width="95%" class=CFAQ><tr class=CFAQ><td class=CFAQ>
+http://www.myserver.mydomain/awstats/awstats.pl?config=mysite\r
+</td></tr></table>
+<br>\r
+where <i>mysite</i> specifies the configuration\r
+file to\r
+use (AWStats will use the file awstats.<i>mysite</i>.conf).<br>\r
+<br>\r
+All output command line options (except -staticlinks) are\r
+also available when using AWStats with a browser. Just use them as URL\r
+parameters: change "-option" to\r
+"&option", i.e. <b><i>http://www.myserver.mydomain/awstats/awstats.pl?month=MM&year=YYYY&output=unknownos</i></b><br>\r
+<br>\r
+Reports are generated in real time from the statistics data\r
+base. If this is slow, or putting too much load on your server,\r
+consider generating static reports instead.<br>\r
+<br>\r
+If the <a href="awstats_config.html#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a>\r
+parameter is set to 1 in AWStats configuration file,\r
+you will also be able to run the update process from your browser. Just\r
+click on the link "Update now".<br>\r
+<br>\r
<br>
-Note (3): If you want to build a report for a particular month, add options <i><b>-month=MM -year=YYYY</b></i>.<br>
-To build a report for full year (warning: This may use a lot of memory and CPU), add options <i><b>-month=all -year=YYYY</b></i>.<br>
-
-<br><br>
-* Second solution is to view dynamically your statistics from a browser. For this, use URL:<br>
-<b><i>http://www.myserver.mydomain/awstats/awstats.pl?config=myvirtualhostname</i></b><br>
-where <i>myvirtualhostname</i> is used to know which config file to use (AWStats will use awstats.<i>myvirtualhostname</i>.conf file).<br>
-<br>
-Note (1): All output command line options (except -staticlinks) are still available when using AWStats as a browser.<br>
-Just use them as URL parameters like this example <b><i>http://www.myserver.mydomain/awstats/awstats.pl?month=MM&year=YYYY&output=unknownos</i></b><br>
-<br>
-Note (2): If <a href="awstats_config.html#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a> parameter is set to 1 in AWStats config/domain file,
-you will also be able to run the update process from your browser. Just click on link "Update now".<br>
-<br><br>
-
<hr>
-
-<script language=javascript>
+<script language="javascript">\r
var date='$Date$';
document.writeln("Last revision: "+date);
</script>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
-<meta name="description" content="AWStats Documentation - What is AWStats, features">
+ <meta name="description"\r
+ content="AWStats Documentation - What is AWStats, features">\r
<meta name="keywords" content="awstats, awstat, features, function">
<meta name="robots" content="index,follow">
<meta name="title" content="AWStats Documentation - What is AWStats">
<link rel="stylesheet" href="styles.css" type="text/css">
<!-- $Revision$ - $Author$ - $Date$ -->
</head>
-
-<body topmargin=10 leftmargin=5>
-
-
-<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
-
-<!-- Large -->
-<tr style="font: 10pt arial,helvetica,verdana">
-<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,sans-serif" color=#EEEEFF><b>AWStats logfile analyzer 6.4 Documentation</b></font><br>
+<body topmargin="10" leftmargin="5">\r
+<table\r
+ style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"\r
+ bgcolor="#ffffff" border="0" cellpadding="0" cellspacing="0"\r
+ width="100%">\r
+<!-- Large --> <tbody>\r
+ <tr\r
+ style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;">\r
+ <td align="center" bgcolor="#9999cc"><a href="/"><img\r
+ src="images/awstats_logo4.png" border="0"></a></td>\r
+ <td align="center" bgcolor="#9999cc"> <br>\r
+ <font\r
+ style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 16pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"\r
+ color="#eeeeff"><b>AWStats logfile analyzer 6.5 Documentation</b></font><br>\r
<br>
</td>
-<td bgcolor=#9999cc align=center>
-
-</td>
+ <td align="center" bgcolor="#9999cc"> </td>\r
</tr>
-
+ </tbody>\r
</table>
-
-
-<br><br><H1 style="font: 26px arial,helvetica,sans-serif">What is AWStats / Features</H1>
-
-<br><br>
-AWStats is a short for Advanced Web Statistics. It's a <b>free powerful and featureful tool that generates advanced web (but also ftp or mail) server statistics, graphically</b>.
-This <b>log analyzer</b> works as a <b>CGI or from command line</b>
-and shows you all possible information your log contains, in <b>few graphical web pages</b>.
-It uses a partial information file to be able to process large log files, often and quickly.
-It can analyze log files from IIS (W3C log format), Apache log files (NCSA combined/XLF/ELF log format or common/CLF log format),
-WebStar and most of all web, proxy, wap, streaming servers (and ftp servers or mail logs).<br>
-Take a look at this <a href="awstats_compare.html#COMPARISON">comparison table</a> for an idea on differences between most famous statistics tools for each features (AWStats, Analog, Webalizer,...).<br>
-AWStats is a free software distributed under the <a href="http://www.gnu.org/copyleft/gpl.html" target=_gnugpl>GNU General Public License</a>. You can have a look at this <a href="docs/awstats_license.html">license chart</a> to know what you can/can't do.<br>
-As AWStats works from the command line but also as a CGI, it can work with major <a href="awstats_whp.html">web hosting provider that allows CGI and log access</a>.<br>
-<br>
-
-
-<br><a name="FEATURES"></a><br>
-<font size=3 color=#665544><b>Features</b></font><br>
-<hr>
- <b>A full log analysis enables AWStats to show you the following information</b>:<br>
- * Number of <u>visits</u>, and number of <u>unique visitors</u>,<br>
- * <u>Visits duration</u> and last visits,<br>
- * <u>Authenticated users</u>, and last authenticated visits,<br>
- * <u>Days of week</u> and <u>rush hours</u> (pages, hits, KB for each hour and day of week),<br>
- * <u>Domains/countries</u> of hosts visitors (pages, hits, KB, <font color=#221188>269 domains/countries detected</font>),<br>
- * <u>Hosts list</u>, last visits and unresolved IP addresses list,<br>
- * <u>Most viewed</u>, <u>entry</u> and <u>exit</u> pages,<br>
- * <u>Files type</u>,<br>
- * <u>Web compression statistics</u> (for mod_gzip or mod_deflate),<br>
- * <u>Browsers</u> used (pages, hits, KB for each browser, each version, <font color=#221188>89 browsers</font>: Web, Wap, Media browsers...),<br>
- * <u>OS used</u> (pages, hits, KB for each OS, <font color=#221188>34 OS detected</font>),<br>
- * <u>Visits of robots</u> (<font color=#221188>310 robots detected</font>),<br>
- * <u>Search engines</u>, <u>keyphrases</u> and <u>keywords</u> used to find your site (<font color=#221188>The 109 most famous search engines are detected like yahoo, google, altavista, etc...</font>),<br>
- * <u>HTTP errors</u> (Page Not Found with last referrer, ...),<br>
- * <u>Other personalized reports</u> based on url, url parameters, referer field for miscellanous/marketing purpose,<br>
- * <u>Screen size</u> (need to add some HTML tags in index page).<br>
- * Number of times your site is "added to favourites bookmarks".<br>
- * Ratio of Browsers with support of: <u>Java, Flash, RealG2 reader, Quicktime reader, WMA reader, PDF reader</u> (need to add some HTML tags in index page).<br>
- * Cluster report for load balanced servers ratio.<br>
-<br>
- <b>AWStats also supports the following features</b>:<br>
- * Can analyze a lot of log formats: Apache NCSA combined log files (XLF/ELF) or common (CLF), IIS log files (W3C),
- WebStar native log files and other web, proxy, wap or streaming servers log files (but also ftp or mail log files). See <a href="awstats_faq.html#LOGFORMAT">AWStats F.A.Q.</a> for examples.<br>
- * Works from command line and from a browser as a CGI (with dynamic filters capabilities for some charts),<br>
- * Update of statistics can be made from a web browser and not only from your scheduler,<br>
- * Unlimited log file size, support split log files (load balancing system),<br>
- * Support 'nearly sorted' log files even for entry and exit pages,<br>
- * Reverse DNS lookup before or during analysis, support DNS cache files,<br>
- * Country detection from IP location (geoip) or domain name.<br>
- * WhoIS links,<br>
- * A lot of options/filters and plugins can be used,<br>
- * Multi-named web sites supported (virtual servers, great for web-hosting providers),<br>
-<!-- * Yearly, monthly and daily statistics,<br> -->
- * Cross Site Scripting Attacks protection,<br>
- * Several languages. See <a href="awstats_faq.html#LANG">AWStats F.A.Q.</a> for full list.<br>
- * No need of rare perl libraries. All basic perl interpreters can make AWStats working,<br>
- * Dynamic reports as CGI output.<br>
- * Static reports in one or framed HTML/XHTML pages, experimental PDF export,<br>
- * Look and colors can match your site design, can use CSS,<br>
- * Help and tooltips on HTML reported pages,<br>
- * Easy to use (Just one configuration file to edit),<br>
- * Analysis database can be stored in XML format for XSLT processing,<br>
- * A Webmin module,<br>
- * Absolutely free (even for web hosting providers), with sources (<a href="docs/awstats_license.html">GNU General Public License</a>),<br>
- * Available on all platforms,<br>
- * AWStats has a <a href="docs/pad_awstats.xml" target=_newawstats>XML Portable Application Description</a>.<br>
+<br>\r
+<br>\r
+<h1\r
+ style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 26px; line-height: normal; font-size-adjust: none; font-stretch: normal;">What\r
+is AWStats / Features Overview<br>\r
+</h1>\r
+<br>\r
+<br>\r
+AWStats is short for <span style="text-decoration: underline;">A</span>dvanced\r
+<span style="text-decoration: underline;">W</span>eb <span\r
+ style="text-decoration: underline;">Stat</span>istic<span\r
+ style="text-decoration: underline;">s</span>. <b>AWStats is </b><b>powerful\r
+log analyzer which creates advanced web, ftp and mail\r
+server statistics reports</b> based on the rich data contained in\r
+server logs. Data is graphically presented in <b>easy to read\r
+web pages</b>.\r
+ \r
+<br>\r
+<br>\r
+Designed with flexibility in mind, AWStats can be run through a web\r
+browser <b>CGI (</b>common\r
+gateway interface) or directly from the operating system<b> command line</b>.\r
+Through the use of intermediary data base files, AWStats is able to\r
+quickly process large log files, as often desired. \r
+With support for both standard and custom log format definitions,\r
+AWStats can analyze log files from Apache (NCSA combined/XLF/ELF or\r
+common/CLF log\r
+format),\r
+Microsoft's IIS (W3C log format),\r
+WebStar and most web, proxy, wap and streaming media servers as well as\r
+ftp and mail server logs.<br>\r
+<br>\r
+See how the most famous open source statistics tools (AWStats, Analog,\r
+Webalizer) stack up feature by feature in this <a\r
+ href="awstats_compare.html#COMPARISON">comparison\r
+table</a>.<br>\r
+<br>\r
+AWStats is free software distributed under the <a\r
+ href="http://www.gnu.org/copyleft/gpl.html" target="_gnugpl">GNU\r
+General Public License</a>. The <a href="docs/awstats_license.html">license\r
+chart</a> illustrates what you\r
+can and cannot do.<br>\r
+As AWStats works from the command line as well as a CGI, it is\r
+compatible with <a href="awstats_whp.html">web hosting providers\r
+which allow CGI and log access</a>.<br>\r
+<br>\r
+<br>\r
+<a name="FEATURES"></a><br>\r
+<font color="#665544" size="3"><b>Features</b></font><br>\r
+<hr> AWStats' reports include a wide range of information on your\r
+web site usage:<br>\r
+* Number of <u>Visits</u>, and number\r
+of <u>Unique visitors</u>.<br>\r
+* <u>Visit duration</u> and\r
+latest visits.<br>\r
+* <u>Authenticated Users</u>, and\r
+latest authenticated visits.<br>\r
+* Usage by <u>Months</u>, <u>Days</u> of week and <u>Hours</u> of the day (pages, hits, KB).<br>\r
+* <u>Domains/countries</u> (and regions, cities and ISP with <a href="http://www.maxmind.com/app/perl?rId=awstats">Maxmind proprietary geo databases</a>) of\r
+visitor's hosts (pages, hits, KB, <font color="#221188">269\r
+domains/countries detected</font>).<br>\r
+* <u>Hosts list</u>, latest visits\r
+and unresolved IP addresses list.<br>\r
+* <u>Most viewed</u>, <u>Entry</u> and <u>Exit</u> pages.<br>\r
+* Most commonly requested <u>File</u>\r
+types.<br>\r
+* <u>Web Compression statistics</u>\r
+(for Apache servers using mod_gzip or\r
+mod_deflate modules).<br>\r
+* Visitor's <u>Browsers</u> (pages,\r
+hits, KB for each browser, each\r
+version, <font color="#221188">121 browsers</font> detected: Web, Wap,\r
+Streaming Media browsers..., around <font color="#221188">500</font> with the "phone browsers" database).<br>\r
+* Visitor's <u>Operating Systems</u>\r
+(pages, hits, KB for each OS, <font color="#221188">35\r
+OS detected</font>).<br>\r
+* <u>Robots</u> visits, including\r
+search engine crawlers (<font color="#221188">351 robots detected</font>).<br>\r
+* <u>Search engines</u>, <u>Keywords</u> and <u>Phrases</u> used to\r
+find your site (<font color="#221188">The 116 most famous search\r
+engines are detected like Yahoo, Google, Altavista, etc...</font>)<br>\r
+* <u>HTTP Errors</u> (Page Not Found\r
+with latest referrer, ...).<br>\r
+* <u>User defined reports</u> based\r
+on url, url parameters,\r
+referrer (referer) fields extend AWStats' capabilities to provide even\r
+greater technical and marketing information.<br>\r
+* Number of times your site is added to <u>Bookmarks / Favorites</u>.<br>\r
+* <u>Screen size</u> (to capture\r
+this, some HTML tags must be added to\r
+a site's home page).<br>\r
+* Ratio of integrated <u>Browser Support\r
+</u>for: Java, Flash, Real G2 player,\r
+Quicktime reader, PDF reader, WMA reader (as above, requires insertion\r
+of HTML tags in site's home page).<br>\r
+* <u>Cluster distribution</u> for\r
+load balanced servers.<br>\r
+<br>\r
+<b>In addition, AWStats provides the following</b>:<br>\r
+* Wide range of log formats. AWStats can analyze: Apache NCSA\r
+combined\r
+(XLF/ELF) or common (CLF) log\r
+files, Microsoft IIS log files (W3C), WebStar\r
+native log files and other web, proxy, wap, streaming media, ftp and\r
+mail server log files. See <a href="awstats_faq.html#LOGFORMAT">AWStats\r
+F.A.Q.</a> for examples.<br>\r
+* Reports can be run from the operating system command line and from a\r
+web browser as a\r
+CGI (common gateway interface). In CGI mode, dynamic filter\r
+capabilities are available for many charts.<br>\r
+* Statistics update can be run from a web browser as well as\r
+scheduled for automatic processing.<br>\r
+* Unlimited log file size<br>\r
+* Load balancing system split log files.<br>\r
+* Support 'nearly sorted' log files, even for entry and exit pages.<br>\r
+* Reverse DNS lookup before or during analysis; supports DNS cache\r
+files.<br>\r
+* Country detection from IP location (geoip) or domain name.<br>
+* Plugins for US/Canadian Regions, Cities and major countries regions, ISP and/or Organizations reports
+(require non free third product <a href="http://www.maxmind.com/app/perl?rId=awstats">geoipregion</a>, <a href="http://www.maxmind.com/app/perl?rId=awstats">geoipcity</a>, <a href="http://www.maxmind.com/app/perl?rId=awstats">geoipisp</a> and/or <a href="http://www.maxmind.com/app/perl?rId=awstats">geoiporg</a> database).<br>
+* WhoIS lookup links.<br>\r
+* Vast array of configurable options/filters and plugins supported.<br>\r
+* Modular design supports inclusion of addition features via plugins.<br>\r
+* Multi-named web sites supported (virtual servers, great for\r
+web-hosting providers).<br>\r
+<!-- * Yearly, monthly and daily statistics,<br> --> * Cross Site\r
+Scripting Attacks protection.<br>\r
+* Reports available in many international languages. See <a\r
+ href="awstats_faq.html#LANG">AWStats F.A.Q.</a> for full list. \r
+Users can provide files for additional languages not yet available.<br>\r
+* No need for esoteric perl libraries. AWStats works with all basic\r
+perl interpreters.<br>\r
+* Dynamic reports through a CGI interface.<br>\r
+* Static reports in one or framed HTML or XHTML pages; experimental PDF\r
+export through 3rd party "htmldoc" software.<br>\r
+* Customize look and color scheme to match your site design; with or\r
+without CSS (cascading style sheets).<br>\r
+* Help and HTML tooltips available in reports.<br>\r
+* Easy to use - all configuration directives are confined to one file\r
+for each site.<br>\r
+* Analysis database can be stored in XML format for use with external\r
+applications through XSLT processing.<br>\r
+* A Webmin module is supplied.<br>\r
+* Absolutely free (even for web hosting providers); source code is\r
+included (<a href="docs/awstats_license.html">GNU General Public License</a>).<br>\r
+* Works on all platforms with Perl support.<br>\r
+* AWStats has a <a href="docs/pad_awstats.xml" target="_newawstats">XML\r
+Portable Application Description</a>.<br>\r
<br>
<b>Requirements</b>:<br>
- To use AWStats, you need the following requirements:<br>
- * Your server must log web access in a log file you can read.<br>
- * You must be able to run perl scripts (.pl files) from command line and/or as CGI.<br>
- If not, you can solve this by downloading last Perl version at <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>
- See <a href="awstats_faq.html#SERVERSOS">AWStats F.A.Q.</a> to have examples of supported OS and Web servers.<br>
+AWStats usage has the following requirements:<br>\r
+* You must have access to the server logs for the reporting you want to\r
+perform\r
+(web/ftp/mail).<br>\r
+* You must be able to run perl scripts (.pl files) from command line\r
+and/or as a CGI. If not, you can solve this by downloading latest\r
+Perl version at <a href="http://www.activestate.com/ActivePerl/">ActivePerl</a>\r
+(<font color="#221188">Win32</font>) or <a\r
+ href="http://www.perl.com/pub/language/info/software.html">Perl.com</a>\r
+(<font color="#221188">Unix/Linux/Other</font>).<br>\r
+See <a href="awstats_faq.html#SERVERSOS">AWStats F.A.Q.</a> for\r
+examples of supported OS and Web servers.<br>\r
<br>
<hr>
-
-<script language=javascript>
+<script language="javascript">\r
var date='$Date$';
document.writeln("Last revision: "+date);
-</script>
-
-<!--
+</script><!--\r
First version of this tool was designed to analyze folowing web sites:
-->
<a href="http://www.chiensderace.com"> </a>
-<a href="http://www.chatsderace.net"> </a>
+<a href="http://www.chatsderace.com"> </a>
</body>
projects / thirdparty / AWStats.git / commitdiff
