From: eldy <> Date: Wed, 18 Apr 2001 00:40:31 +0000 (+0000) Subject: no message X-Git-Tag: AWSTATS_1_0~317 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d2bce4dc934f86f044f6bfae889a0f4ef32eaa0c;p=thirdparty%2FAWStats.git no message --- diff --git a/INSTALL.TXT b/INSTALL.TXT index ebadb504..a2837e20 100644 --- a/INSTALL.TXT +++ b/INSTALL.TXT @@ -1 +1 @@ -Setup instructions are in README.TXT file. \ No newline at end of file +Setup instructions are in README.TXT file. \ No newline at end of file diff --git a/README.TXT b/README.TXT deleted file mode 100644 index 655cf220..00000000 --- a/README.TXT +++ /dev/null @@ -1,291 +0,0 @@ - -------------- AWStats -------------- - Advanced Web Statistics ------------------------------------- - -Advanced Web Statistics (AWStats) is a powerfull web server logfile analyzer -(Perl script) that shows you all your Web statistics including visitors, -pages, hits, hours, search engines, keywords used to find your site, broken -links, robots and more. It works with IIS 5.0+ or Apache webserver log files. - -License: GNU GPL (GNU General Public License. See COPYING.TXT) -Version : 2.24 -Release date: 20 January 2001 -Platforms: All (Linux, NT, SCO, BSD, Solaris and other *NIX's, BeOS, OS/2...) -Author: Laurent Destailleur -AWStats web site: http://awstats.sourceforge.net - -I - Features and requirements of AWStats - I - 1) Features, what AWStats can show you - I - 2) Requirements for using AWStats - I - 3) Files -II - How to install and use AWStats - II - 1) With Apache server - II - 2) With IIS 5.0+ -III - Benchmark -IV - Troubleshouting / FAQ -V - About the author, license and support - - - -I - FEATURES AND REQUIREMENTS ------------------------------------- - -I - 1) Features - - A full log analysis enables AWStats to show you the following information: - * number of VISITS and UNIQUE VISITORS, - * most often pages viewed - * domains/countries of hosts visitors (pages,hits,kb), - * rush hours (pages,hits,kb for each hour), - * browsers used (pages,hits,kb for each browsed), - * OS used (pages,hits,kb for each OS), - * VISITS OF ROBOTS, - * SEARCH ENGINES and KEYWORDS used to find your site, - * HTTP errors. - - It supports the following features as well: - * Command line scheduled analysis or real-time analysis - * Easy to install, easy to use (No compilation, no extern databases, only - one .pl file), - * Tooltips and explanations for each informations pointed by mouse, - * Multi-named web sites supported, - * Informations are since the start of your web site and month by month, - * 8 languages: English, French, Dutch (Christtian Langeveld), Spanish - (Rodrigo Villarreal), Italian (Vittore Zen), German (Ulf Moench), Polish - (Tomasz Ciemnoczulowski), Greek (Simos Xenitellis) - * Colored graphics, - * Free and distributed with sources (perl script). - -I - 2) Requirements - - To use AWStats CGI script, you need the following requirements: - * Your Web server must be able to log web access in "NCSA combined logfile - format" like Apache or in "Extended W3C logfile format" like IIS 5.0+ - * You need to have read (better if read/write) access to your logfile - server. If you can have only a read access, for example with IIS that - doesn't allow write access on its lofgile, AWStats will automatically - work differently, but slower than with read/write access). - * To run awstats, from command line, your operating system must be able to - run perl scripts (.pl files). To run awstats as a CGI (for real-time - statistics), your web server must be able to run such scripts. - If not, you can solve this by downloading last Perl version at: - http://www.activestate.com/ActivePerl/ (Win32) - http://www.perl.com/pub/language/info/software.html (Unix/Linux/Other) - - -I - 3) Files - - The distribution of AWStats include the following files: - awstats.pl The main CGI/command line perl script - awstats.model.conf A model of AWStats configure file - COPYING.TXT Information file on GNU General Public Licence - README.TXT This file - INSTALL.TXT To say setup manual is in README.TXT file - robotslist.txt Information file on robots (useless for AWStats) - browser Directory with browsers icons - clock Directory with clocks icons - cpu Directory with cpu icons - flags Directory with country flags icons - os Directory with os icons - other Directory with all others icons - - -II - HOW TO INSTALL AND USE AWSTATS ------------------------------------ - -II - 1) With Apache Server - - * Configure your apache web server to have "combined" log format. - You can do this by changing, in httpd.conf, following directives: - CustomLog /yourlogpath/yourlogfile common - into - CustomLog /yourlogpath/yourlogfile combined - See your apache manual for more informations. Don't forget to restart - apache to activate changes. - This is an example of what you should get then in your log file: - 62.161.78.73 - - [dd/mmm/yyyy:hh:mm:ss +0000] "GET / HTTP/1.1" 200 1234 "http://www.from.com/from.htm" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)" - - * Put awstats.pl file in your cgi-bin directory (or other cgi directory). - Check that this file has right permissions to be runned. - - * If necessary (on some Unix OS), in awstats.pl file, edit the first line - #!/usr/bin/perl - to reflect the path were your perl interpreter is installed. It might be - #!/usr/local/bin/perl - - * Move all awstats icons sub-directories into a directory readable by your - web server, for example /yourwwwroot/icon. - - * Copy awstats.model.conf into awstats.www.myserver.mydomain.conf or - awstats.conf (when you will run AWStats, it will first look for a config - file called awstats.www.myserver.mydomain.conf, and, if not found, will - look for awstats.conf). Whatever the name you choose, this new file must - be stored in same directory than awstats.pl (so cgi-bin directory) and - edit it with your own setup : - - Change "LogFile" value with full path of your web server log file. You - can use a relative path from your awstats.pl directory. - - Check if "LogFormat" has the value "1" (it means "apache combined log - format"). - - Change the "DirIcons" parameter to reflect URL of icons directory. - - You can change other parameters if you want. - - * Before using AWStats from your browser, launch awstats.pl from the - command line (the first time, process may be long), like this: - > awstats.pl -h www.myserver.mydomain - where www.myserver.mydomain is the URL you use to access your web site. - AWStats will use awstats.www.myserver.mydomain.conf config file, and, if - not found, will use awstats.conf. - - This command help you see if AWStats setup is good and because, the - first time, the AWStats process is slow (one second for each 570 lines - of your logfile with Pentium 300, plus DNS resolution time for each - different IP address in your logfile). - The result, an HTML code page on your screen, means you can now run - AWStats from your browser. For example with this URL : - htpp://www.myserver.mydomain/cgi-bin/awstats.pl - You can also use this URL to choose parameters of a particular site : - htpp://www.myserver.mydomain/cgi-bin/awstats.pl?site=virtualhost - where virtualhost is a name of another web server (AWStats will use - awstats.virtualhost.conf file). - - * Add something in your crontab (Unix/Linux), or something else, to launch - the following command : - > awstats.pl -h www.myserver.mydomain - where www.myserver.mydomain is the URL used to access your web site. - For sites with: - - 1,000 visits a month Launch AWStats once a day (23h55 for example) - - 10,000 visits a month Launch AWStats every 4 hours or more often - - 50,000 visits a month Launch AWStats every hour - - 200,000 visits a month Launch AWStats every 15mn - This is necessary to keep good performances. - - -II - 2) With IIS Server - - * Configure IIS to have "Extended W3C log format" with following fields: - date time c-ip c-username cs-method cs-uri-sterm sc-status cs-bytes cs-version cs(User-Agent) cs(Referer) - or - date time c-ip c-username cs-method cs-uri-sterm sc-status cs-bytes cs-version cs-host cs(User-Agent) cs(Referer) - This is an example of what you should get: - 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 - or - 2000-07-19 14:14:14 62.161.78.73 - GET / 200 1234 HTTP/1.1 hostserver Mozilla/4.0+(compatible;+MSIE+5.01;+Windows+NT+5.0) http://www.from.com/from.htm - - * Put awstats.pl file in your cgi-bin directory (or other cgi directory). - - * Move all awstats icons sub-directories into a directory readable by your - web server, for example C:\yourwwwroot\icon and change the "DirIcons" - parameter in configure file to reflect this directory (Ie: /icon). - - * Copy awstats.model.conf into awstats.www.myserver.mydomain.conf or - awstats.conf (when you will run AWStats, it will first look for a config - file called awstats.www.myserver.mydomain.conf, and, if not found, will - look for awstats.conf). Whatever the name you choose, this new file must - be stored in same directory than awstats.pl (so cgi-bin directory) and - edit it with your own setup : - - Change "LogFile" value with full path of your web server log file. You - can use a relative path from your awstats.pl directory. - - Change "LogFormat" to value "2" (it means "IIS log format"). - - Change "DirIcons" parameter to reflect URL of icons directory. - - You can change other parameters if you want. - - * Before using AWStats from you're browser, launch awstats.pl from the - command line: - > awstats.pl -h www.myserver.mydomain - where www.myserver.mydomain is the URL you use to access your web site. - AWStats will use awstats.www.myserver.mydomain.conf config file, and, if - not found, will use awstats.conf. - - This command help you see if AWStats setup is good and because, the - first time, the AWStats process is slow (one second for each 570 lines - of your logfile with Pentium 300, plus DNS resolution time for each - different IP address in your logfile). - The result, an HTML code page on your screen, means you can now run - AWStats from your browser. For example with this URL : - htpp://www.myserver.mydomain/cgi-bin/awstats.pl - You can also use this URL to choose parameters of a particular site : - htpp://www.myserver.mydomain/cgi-bin/awstats.pl?site=virtualhost - where virtualhost is a name of another web server (AWStats will use - awstats.virtualhost.conf file). - - * Add something in a task scheduler, or something else, to launch at the - following command : - > awstats.pl -h www.myserver.mydomain - where www.myserver.mydomain is the URL used to access your web site. - For sites with: - - 1,000 visits a month Launch AWStats once a day (23h55 for example) - - 10,000 visits a month Launch AWStats every 4 hours or more often - - 50,000 visits a month Launch AWStats every hour - - 200,000 visits a month Launch AWStats every 15mn - This is necessary to keep good performances. - - !!! Warning, with IIS, Windows doesn't let AWStats to purge log file - after processing it, so performance won't be as good as with Apache - server. - It's very important you purge your log file yourself (or let IIS doing - it), if you don't want to have very bad performances. - The more often you clean your log file, the more faster AWStats will be - (See benchmark chapter to known what you can hope). - - !!! Warning: if your log filename is different each month or day (with - IIS, think to launch awstats just before the end of month or day. If you - forget it, you will also forget statistics for this month or day. - - - -III - BENCHMARK ------------------------------------ - -With version 2.23, AWStats processes 570 lines by seconds (Pentium 300Mhz). -If we consider 10 hits by page and 5 pages for one visits, it means that -AWStats is able to analyze 11 visits in one second. -If your site has 70 visits each hour (50,000 visits a month), you should -launch AWStats each hour to be sure to get a processing time less than -70/11 = 6.4 seconds (with Pentium 300Mhz). In fact, process time might be -higher because of DNS reverse lookup that is time consuming. -DNS lookup speed depends on your system, network and Internet but not on the -log analyzer you use. For this reason, DNS lookup is disabled in all log -analyzer benchmarks, but you must keep in mind that it's the most time -consuming part of the process. -To increase speed: -- You can disable DNSLookup in AWStats (set DNSLookup=0) but this requires -that hosts adresses in your log file are already resolved (need to setup your -web server to do so). Speed can be increased up by 2 to 100 times ! -- If you use Apache, set PurgeLogFile to 1 (By default, to avoid bad surpise, -PurgeLogFile is 0 in configure file, but you can set it to 1 to ask AWStats -to purge log file after processing it, this increase speed for next run). -- Launch AWStats more often (from crontab or a scheduler). The more often you -launch AWStats, the less AWStats has new lines in log to process. -- Use last AWStats version - - -IV - TROUBLESHOUTING / FAQ ------------------------------------ -All AWStats FAQ are availabe on AWStats Official web site: -http://awstats.sourceforge.net - - -V - ABOUT THE AUTHOR, LICENSE AND SUPPORT ------------------------------------------ -Copyright (C) 2000 Laurent Destailleur - -This program is free software; you can redistribute it and/or -modify it under the terms of the GNU General Public License -version 2 as published by the Free Software Foundation. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details, in COPYING.TXT file. - -If you have not received a copy of this file along with this program, write to -the Free Software Foundation, Inc., -59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. - - -You can download latest version at the following URL: -http://awstats.sourceforge.net - -You can send or ask help to: -eldy@users.sourceforge.net