awstats-plugin-geoip-allregions

OVERVIEW

This package contains a plugin for awstats.  On Debian it is installed
with the other plugins in /usr/share/awstats/plugins.  This plugin
will generate a Region table and place region information in the Host
table within an AWStats report.  It is similar to the
geoip_region_maxmind plugin, which generates U.S. and Canada Region
information from MaxMind's region database.  However, this plugin
generates worldwide region information from MaxMind's city database.
They offer a free version, GeoLiteCity.dat, for download from:

  http://www.maxmind.com/download/geoip/database/

Decompress it and install it in this directory on Debian:

  /usr/share/GeoIP/

That database is the "free" version and they update it monthly.  They
also offer a more accurate licensed version.  For more information,
see:

  http://www.maxmind.com/app/geolitecity

USAGE

In your awstats configuration file (under /etc/awstats), you can add a
section like this:

# Plugin: GeoIP_AllRegions
# Perl modules required: Geo::IP (from Maxmind)
# This plugin adds a chart of hits by region (with country information).
# Note: This plugin needs the Maxmind GeoIP Perl module AND the city database.
# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
# on Windows but it works great on Linux with default Perl.
# There are two versions of the Maxmind City Database:
# You can get a free version or purchase a license from Maxmind to get/use a more
# accurate version including updates (http://www.maxmind.com/app/perl?rId=awstat)
# This plugin reduces AWStats speed.
#
LoadPlugin="geoip_allregions GEOIP_STANDARD /usr/share/GeoIP/GeoIPCity.dat"

 -- Ken Neighbors <ken@nsds.com>, Tue May 16 08:46:24 2006
