AWFFull

AWFFull Homepage

apt-get install awffull libgd2-xpm

GeoIP Country detection

apt-get install geoip-bin 

in /etc/awffull/awffull.conf:

GeoIP          yes

Actually awffull is not compiled with GeoIP support but we can rebuild the package

awffull -v (interrupt it, it's at the beginning)
=> GeoIP is not available in this binary. Ignoring request to use.

ok, don't be impressed ;-)
the building process of awffull is pretty well done, if it detects the headers of GeoIP it uses it, as simply as that.

apt-get build-dep awffull
apt-get source awffull
cd awffull-3.7.1/
apt-get install libgeoip1 libgeoip-dev
dpkg-buildpackage -uc -b 

Et voilà! You can install the new .deb freshly created.
Now you can run it, it will give e.g.

awffull -v
=> awffull 3.7.1 (Linux 2.6.17-2-vserver-amd64) English
=> Using GeoIP for IP Address Lookups: /usr/share/GeoIP/GeoIP.dat

One bad point: we didn't fix the dependancies of our new package, for a local use this is ok but for larger use we should have added the libgeoip1 package in the list of dependencies of awffull.

---

To get city level geolocalisation we can get the free db:

mkdir /usr/local/share/GeoIP
cd /usr/local/share/GeoIP
wget http://www.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz
gunzip GeoLiteCity.dat.gz
ln -s /usr/local/share/GeoIP/GeoLiteCity.dat /usr/share/GeoIP/GeoIPCity.dat

---

see an Apache example in http://www.justbiit.com/awffull/ or Zope in http://www.justbiit.com/zawffull/ or Plone in http://www.justbiit.com/pawffull/

Don't forget to point to the right log file : /var/log/apache2/access.log in the /etc/awffull/awffull.conf

Cheers on the cake : You are using different webservers like apache, zope, plone, etc.. and you would like to have statistics for each one :

cd /etc/awffull
cp /etc/awffull/awffull.conf /etc/awffull/zawffull.conf
cp /etc/awffull/awffull.conf /etc/awffull/pawffull.conf

Edit pawffull.conf for Plone

LogFile /var/log/zope2.9/plone-site/Z2.log
OutputDir /var/www/pawffull

Edit zawffull.conf for Zope

LogFile /var/log/zope2.9/zope/Z2.log
OutputDir /var/www/zawffull

Create the output directory

mkdir /var/www/zawffull
mkdir /var/www/pawffull

That is it, the /etc/cron.daily/awffull will execute each .conf file of the /etc/awffull directory !

awffull -c /etc/awffull/awffull.conf
awffull -c /etc/awffull/zawffull.conf
awffull -c /etc/awffull/pawffull.conf