There are a number of websites and servers that I want to track stats for.<\/p>\n
Each individual CPanel includes Awstats by default, but I have a number of dedicated servers that don’t\u00a0 have cpanel, and clients that want stats access who I don’t want to give access to the CPanel too (yep, I don’t trust them!)<\/p>\n
So this is about installing a stand-alone Awstats with all features and a login process for the various clients to view the relevant areas or servers and domains that will be monitored.<\/p>\n
This will include:<\/p>\n
First up the Awstats server is a Linux Debian Squeeze (6.0.6) setup and installing Awstats is the starting point.<\/p>\n
I referenced a number of sites including:<\/p>\n
and all of them have helpful information but not quite aligned to what I found on my server.<\/p>\n
The simple command for getting Awstats is:<\/p>\n
[bash]
\napt-get install awstats
\n[\/bash]<\/p>\n
Next there are some fix ups and notes:<\/p>\n
To start with the apt-get does not unzip the model file or create the appropriate directories. (Considering that this has been documented for around 5 years I am wondering why someone has not fixed it. I might even give it a try myself, but the tweaks are minor)<\/p>\n
So create the correct directories in \/usr\/share\/doc\/awstats\/examples#<\/p>\n
[bash]
\n\/usr\/share\/doc\/awstats\/examples# mkdir -p wwwroot\/cgi-bin
\n[\/bash]<\/p>\n
Next copy the .gz file to the new directory<\/p>\n
[bash]
\n\/usr\/share\/doc\/awstats\/examples#\u00a0cp awstats.model.conf.gz\u00a0wwwroot\/cgi-bin
\n[\/bash]<\/p>\n
Next unzip the .gz file<\/p>\n
[bash]
\n\/usr\/share\/doc\/awstats\/examples#\u00a0cd \u00a0wwwroot\/cgi-bin<\/p>\n
\/usr\/share\/doc\/awstats\/examples\/wwwroot\/cgi-bin\/#gunzip\u00a0\u00a0awstats.model.conf.gz
\n[\/bash]<\/p>\n
Running the configure script for Awstats is next but check that we have appropriate answers for the questions:<\/p>\n
The Apache default config file path is \/etc\/apache2\/httpd.conf but, I prefer to use the sites-available construct and have a distinct config for the sites on the server, so.. \/etc\/apache2\/sites-available\/001-awstats will be the config file that I use<\/p>\n
The site name is whatever your site is and I’ll use the default web site for this server just to get it going<\/p>\n
[bash]
\n\/usr\/share\/doc\/awstats\/examples# perl awstats_configure.pl
\n—– AWStats awstats_configure 1.0 (build 1.8) (c) Laurent Destailleur
\n—– This tool will help you to configure AWStats to analyze statistics for one web server.
\nYou can try to use it to let it do all that is possible in AWStats setup, however following
\nthe step by step manual setup documentation (docs\/index.html) is often a better idea.
\nAbove all if:
\n– You are not an administrator user,
\n– You want to analyze downloaded log files without web server,
\n– You want to analyze mail or ftp log files instead of web log files,
\n– You need to analyze load balanced servers log files,
\n– You want to ‘understand’ all possible ways to use AWStats…
\nRead the AWStats documentation (docs\/index.html).<\/p>\n
—–> Running OS detected: Linux, BSD or Unix Warning: AWStats standard
\ndirectory on Linux OS is ‘\/usr\/local\/awstats’.
\nIf you want to use standard directory, you should first move all content
\n of AWStats distribution from current directory:
\n\/usr\/share\/doc\/awstats\/examples to standard directory: \/usr\/local\/awstats
\nAnd then, run configure.pl from this location.
\nDo you want to continue setup from this NON standard directory [yN] ?
\nANSWER = y<\/p>\n
—–> Check for web server install
\nEnter full config file path of your Web server. Example: \/etc\/httpd\/httpd.conf
\nExample: \/usr\/local\/apache2\/conf\/httpd.conf
\nExample: c:Program filesapache groupapacheconfhttpd.conf
\nConfig file path (‘none’ to skip web server setup): >
\nANSWER = \/etc\/apache2\/sites-available\/001-awstats<\/p>\n
—–> Check and complete web server config file ‘\/etc\/apache2\/sites-available\/001-awstats’
\n \u00a0 All AWStats directives are already present.<\/p>\n
—–> Update model config file ‘\/usr\/share\/doc\/awstats\/examples\/wwwroot\/cgi-bin\/awstats.model.conf’
\nFile awstats.model.conf updated.<\/p>\n
—–> Need to create a new config file ?
\nDo you want me to build a new AWStats config\/profile file (required if first install) [y\/N] ?
\nANSWER = y<\/p>\n
—–> Define config file name to create What is the name of your web site or profile analysis ?
\nExample: <a href="http:\/\/www.mysite.com">www.mysite.com<\/a>
\nExample: demo Your web site, virtual server or profile name: >
\nANSWER = default-web-site.your-domain.tld.somewhere<\/p>\n
—–> Define config file path In which directory do you plan to store your config file(s) ?
\nDefault: \/etc\/awstats Directory path to store config file(s) (Enter for default): >
\nANSWER = [Enter for Default]<\/p>\n
—–> Create config file ‘\/etc\/awstats\/awstats.default-web-site.your-domain.tld.somewhere.conf’
\nConfig file \/etc\/awstats\/awstats.default-web-site.your-domain.tld.somewhere.conf created.<\/p>\n
—–> Add update process inside a scheduler
\nSorry, configure.pl does not support automatic add to cron yet.
\nYou can do it manually by adding the following command to your cron:
\n \/usr\/share\/doc\/awstats\/examples\/wwwroot\/cgi-bin\/awstats.pl -update -config=default-web-site.your-domain.tld.somewhere
\nOr if you have several config files and prefer having only one command:
\n\/usr\/share\/doc\/awstats\/examples\/tools\/awstats_updateall.pl now
\nPress ENTER to continue…<\/p>\n
A SIMPLE config file has been created:
\n \/etc\/awstats\/awstats.default-web-site.your-domain.tld.somewhere.conf
\nYou should have a look inside to check and change manually main parameters.
\nYou can then manually update your statistics for ‘default-web-site.your-domain.tld.somewhere’ with command:
\n > perl awstats.pl -update -config=default-web-site.your-domain.tld.somewhere
\n You can also read your statistics for ‘default-web-site.your-domain.tld.somewhere’ with URL:
\n > <a href="http:\/\/localhost\/awstats\/awstats.pl?config=default-web-site.your-domain.tld.somewhere">http:\/\/localhost\/awstats\/awstats.pl?config=default-web-site.your-domain.tld.somewhere<\/a><\/p>\n
Press ENTER to finish…<\/p>\n
[\/bash]<\/p>\n
Next edit the apache config file that was created by the script, in my example it is \/etc\/apache2\/sites-available\/001-awstats
\nAdd this section for the awstats-icon alias. I suggest near the top of the file after the CGI script directives rather than the bottom.<\/p>\n
[text]
\nAlias \/awstatsicons\/ \/usr\/share\/awstats\/icon\/
\n<Directory \/usr\/share\/awstats\/icon>
\n \u00a0 Options None
\n \u00a0 AllowOverride None
\n \u00a0 Order allow,deny
\n \u00a0 Allow from all
\n<\/Directory>
\n[\/text]<\/p>\n
There may be a pointer in the file already for Alias<\/p>\n
[text]
\nAlias \/awstatsicon "\/usr\/share\/awstats\/examples\/wwwroot\/icon\/"
\n[\/text]<\/p>\n
If there is then it is incorrect. Just use a # at the start of the line to disable it.<\/p>\n
To complete the Apache config enable the new 001-awstats site and restart apache2<\/p>\n
[bash]
\n\/etc\/apache2\/sites-enabled# a2ensite
\n\/etc\/apache2\/sites-enabled# apachectl graceful
\n[\/bash]<\/p>\n
You can also use “service apache2 graceful” with same outcome
\nNext in the \/etc\/awstats\/ directory find the awstats.your-domain-name.conf file that was created earlier.
\nEdit the file around line 51 MAIN SETUP SECTION and change the log file location for the default web site
\nfrom<\/p>\n
[text]LogFile="\/var\/log\/httpd\/mylog.log"[\/text]<\/p>\n
to<\/p>\n
[text]LogFile="\/var\/log\/apache2\/access.log"[\/text]<\/p>\n
everything else should be ok as a default.<\/p>\n
So now we have a configured Awstats for a basic test. Try running this command<\/p>\n
[bash]\/etc\/awstats# \/usr\/lib\/cgi-bin\/awstats.pl -config=default-web-site.your-domain.tld.somewhere[\/bash]<\/p>\n
Remember that the -config option here must match the awstats.default-web-site.your-domain.tld.somewhere.conf of the file created earlier. Except do not include the awstats. or the .conf as this prefix and suffix are automatically assumed by the application.<\/p>\n
The response should look something like this:<\/p>\n
[bash]<\/p>\n
Create\/Update database for config "\/etc\/awstats\/awstats.default-web-site.your-domain.tld.somewhere.conf" by AWStats version 6.95 (build 1.943)
\nFrom data in log file "\/var\/log\/apache2\/access.log"…
\nPhase 1 : First bypass old records, searching new record…
\nSearching new records from beginning of log file…
\nPhase 2 : Now process new records (Flush history on disk after 20000 hosts)…
\nJumped lines in file: 0
\nParsed lines in file: 28
\nFound 0 dropped records,
\nFound 0 corrupted records,
\nFound 0 old records,
\nFound 28 new qualified records.<\/p>\n
[\/bash]<\/p>\n
Finally the test is to check that it is alive ! In a web browser try the following substituting the example domain in the URL and as the config to check.<\/p>\n
[text]
\nhttp:\/\/default-web-site.your-domain.tld.somewhere\/cgi-bin\/awstats.pl?config=default-web-site.your-domain.tld.somewhere
\n[\/text]<\/p>\n
Ok, so that works.<\/p>\n
Now to\u00a0configure a\u00a0process to update the stats from the logs<\/p>\n
awstats_updateall.pl\u00a0 is the perl script that will do this, but it is sitting in an odd place under examples. I moved it just to have it in a more logical place alongside the awstats.pl script.\u00a0 This is not essential.<\/p>\n
[bash]
\n#cd \/usr\/share\/doc\/awstats\/examples\/
\n\/usr\/share\/doc\/awstats\/examples# cp awstats_updateall.pl \/usr\/lib\/cgi-bin\/
\n[\/bash]<\/p>\n