What is Awstats ?

AWStats is an open source Web analytics reporting tool, suitable for analyzing data  from Internet  services such as web, streaming media, mail and FTP servers. AWStats parses and analyzes server log files, producing HTML reports. Data is visually presented within reports by tables and bar graphs. Static reports can be created through a command line interface, and on-demand reporting is supported through a web browser CGI program.

Download the awstats

Login as Root into your server

#cd /root
#wget http://prdownloads.sourceforge.net/awstats/awstats-6.95.tar.gz
#tar -xzvf awstats-6.95.tar.gz
#cd awstats-6.95
#mv awstats-6.95 awstats
#mv awstats /home/domains/wowtutorial.org/htdocs
#cd /home/domains/wowtutorial.org/htdocs/awstats/tools/
#./awstats_configure.pl


----- AWStats awstats_configure 1.0 (build 1.8) (c) Laurent Destailleur -----
This tool will help you to configure AWStats to analyze statistics for
one web server. You can try to use it to let it do all that is possible
in AWStats setup, however following the step by step manual setup
documentation (docs/index.html) is often a better idea. Above all if:
- You are not an administrator user,
- You want to analyze downloaded log files without web server,
- You want to analyze mail or ftp log files instead of web log files,
- You need to analyze load balanced servers log files,
- You want to 'understand' all possible ways to use AWStats...
Read the AWStats documentation (docs/index.html).

-----> Running OS detected: Linux, BSD or Unix
Warning: AWStats standard directory on Linux OS is '/usr/local/awstats'.
If you want to use standard directory, you should first move all content
of AWStats distribution from current directory:
/home/domains/wowtutorial.org/htdocs/awstats/
to standard directory:
/usr/local/awstats
And then, run configure.pl from this location.
Do you want to continue setup from this NON standard directory [yN] ? y

-----> Check for web server install

Enter full config file path of your Web server.
Example: /etc/httpd/httpd.conf
Example: /usr/local/apache2/conf/httpd.conf
Example: c:Program filesapache groupapacheconfhttpd.conf
Config file path ('none' to skip web server setup):
 > /usr/local/apache2/conf/httpd.conf

-----> Check and complete web server config file

'/usr/local/apache2/conf/httpd.conf'
Add 'Alias /awstatsclasses

"/home/domains/wowtutorial.org/htdocs/awstats/wwwroot/classes/"'
Add 'Alias /awstatscss

"/home/domains/wowtutorial.org/htdocs/awstats/awstats/wwwroot/css/"'
Add 'Alias /awstatsicons

"/home/domains/wowtutorial.org/htdocs/awstats/awstats/wwwroot/icon/"'
Add 'ScriptAlias /awstats/

"/home/domains/wowtutorial.org/htdocs/awstats/awstats/wwwroot/cgi-bin/"'
Add '' directive
AWStats directives added to Apache config file.

-----> Update model config file

'/home/domains/wowtutorial.org/htdocs/awstats/wwwroot/cgi-bin/awstats.model.conf'
File awstats.model.conf updated.

-----> Need to create a new config file ?
Do you want me to build a new AWStats config/profile
file (required if first install) [y/N] ? y

-----> Define config file name to create
What is the name of your web site or profile analysis ?
Example: www.mysite.com
Example: demo
Your web site, virtual server or profile name:
 > wowtutorial.org

-----> Define config file path
In which directory do you plan to store your config file(s) ?
Default: /etc/awstats
Directory path to store config file(s) (Enter for default):
 >

-----> Create config file '/etc/awstats/awstats.wowtutorial.org.conf'
 Config file /etc/awstats/awstats.wowtutorial.org.conf created.
Sorry, configure.pl does not support automatic add to cron yet.
You can do it manually by adding the following command to your cron:
/home/domains/wowtutorial.org/htdocs/awstats/wwwroot/cgi-bin/awstats.pl

-update -config=wowtutorial.org
Or if you have several config files and prefer having only one command:
/home/domains/wowtutorial.org/htdocs/awstats/tools/awstats_updateall.pl now
Press ENTER to continue...

A SIMPLE config file has been created:

/etc/awstats/awstats.202.99.198.186.conf
You should have a look inside to check and change manually main parameters.
You can then manually update your statistics for '202.99.198.186' with

command:
 > perl awstats.pl -update -config=202.99.198.186
You can also read your statistics for '202.99.198.186' with URL:
 > http://localhost/awstats/awstats.pl?config=202.99.198.186

Press ENTER to finish...

Edit config

#vi /etc/awstats/awstats.www.wowtutorial.org.conf
##.- edit this line -.##

DirData="/var/lib/awstats/"
## to ##
DirData="/home/domains/wowtutorial.org/htdocs/awstats/"

update manually

#/home/domains/wowtutorial.org/htdocs/awstats/wwwroot/cgi-bin/awstats.pl -update -config=www.wowtutorial.org

Create/Update database for config

"/etc/awstats/awstats.www.wowtutorial.org.conf" by AWStats version 6.95 (build 1.943) From data in log file

"/usr/apachelogs/domains/2010/02/10/wowtutorial.org.access_log"...
Phase 1 : First bypass old records, searching new record...
Direct access after last parsed record (after line 2435)
Jumped lines in file: 2435
 Found 2435 already parsed records.
Parsed lines in file: 310
 Found 0 dropped records,
 Found 0 corrupted records,
 Found 0 old records,
 Found 310 new qualified records.

Create crontab

*/30 * * * * /home/domains/wowtutorial.org/htdocs/awstats/wwwroot/cgi-bin/awstats.pl -update -config=www.wowtutorial.org

Create .htaccess

#cd /home/domains/wowtutorial.org/htdocs/awstats/wwwroot/cgi-bin/
#vi .htaccess

<FilesMatch "awstats.pl">
AuthName "Login Required"
AuthType Basic
AuthUserFile /home/domains/wowtutorial.org/htdocs/awstats/wwwroot/.ok_user
require valid-user
</FilesMatch>

#/usr/bin/htpasswd -c /home/domains/wowtutorial.org/htdocs/awstats/wwwroot/.ok_user admin

Set httpd.conf to accept htaccess

#vi /usr/local/apache2/conf/httpd.conf

### changes Options and AllowOverride ###

<Directory "/home/domains/wowtutorial.org/htdocs/awstats/wwwroot">
    Options Indexes Multiviews
    AllowOverride AuthConfig
    Order allow,deny
    Allow from all
</Directory>

Restart httpd

/usr/local/apache2/bin/apachectl stop
/usr/local/apache2/bin/apachectl start

Testing the awstats

http://www.wowtutorial.org/awstats/awstats.pl