MaxMind GeoIP Country Module - Linux Installation


After purchasing the MaxMind GeoIP Country database from MaxMind, follow these steps to download the correct database package:

  1. Login to the MaxMind Member Center.
  2. Click on the Download Files link in the menu on the left side of the page.
  3. Download the latest version of MaxMind GeoIP Country Binary for APIs in GZIP format. Ensure that you download the correct binary format, which is tagged with an ID of GEO-106.

Tip Tip

If you've purchased an update subscription from MaxMind, you will likely want to install the geoipupdate program to automatically download new updates every week. It is available as part of the GeoIP C Library distribution. To download it, click on the Automatic Updates link in the menu on the left side of MaxMind Member Center home page. Once installed, the location of the GeoIP file will be: /usr/local/share/GeoIP/GeoIP.dat


Upload the GeoIP-106_YYYYMMDD.tar.gz file that you've downloaded to your web server. It doesn't matter where you upload it, just so long as you can get access to it easily from the command shell of your choice. Once you've uploaded the file, you will need to execute the following commands to install it:

gunzip GeoIP-106_YYYYMMDD.tar.gz
tar -xf GeoIP-106_YYYYMMDD.tar
mkdir /path/to/webapps/advertpro/modules
cp GeoIP-106_YYYYMMDD/GeoIP-106_YYYYMMDD.dat /path/to/webapps/advertpro/modules/GeoIPCountry.dat


If you have already installed AdvertPRO, you will need to edit the ~/webapps/advertpro/config/ file to enter the path to the GeoIPCountry.dat file that you've just installed.

The file should contain the following when you're done:

#Tue Mar 02 21:41:22 EST 2004

After this configuration is completed, contact technical support at Renegade Internet and ask them to enable GeoIP Country for your license key. Do not do this until you have uploaded the GeoIP database and edited the configuration file! Doing so will result in the GeoIP module failing to load and abort startup.

Finishing Up

In order for AdvertPRO to load your newly installed MaxMind Country module, you will need to restart your application server.

/etc/rc.d/init.d/tomcat restart

That's it. Congratulations, you've successfully installed the MaxMind Country module!

Note Note

Your application server does not need to be restarted every time the GeoIP database file is updated. This is only necessary the first time it is loaded. AdvertPRO will monitor the GeoIP database file for changes and reload it automatically.


If you have problems with AdvertPRO starting back up after the installation, you may find some helpful information in the ~/webapps/advertpro/logs/error_log_YYYY-MM-DD file to assist you with troubleshooting.