MaxMind GeoIP City Module - Linux Installation

Downloading

After purchasing the MaxMind GeoIP City 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 City (new format with DMA/Area Codes) Binary for C and Perl APIs in GZIP format. Ensure that you download the new format, which is tagged with an ID of GEO-133. AdvertPRO is not compatible with the older format.

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/GeoIPCity.dat

Installation

Upload the GeoIP-133_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-133_YYYYMMDD.tar.gz
tar -xf GeoIP-133_YYYYMMDD.tar
mkdir /path/to/webapps/advertpro/modules
cp GeoIP-133_YYYYMMDD/GeoIPCity-133.dat /path/to/webapps/advertpro/modules/GeoIPCity.dat

Configuration

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

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


#WARNING: DO NOT EDIT THIS FILE DIRECTLY!!!
#Tue Mar 02 21:41:22 EST 2004
FILENAME=/path/to/webapps/advertpro/modules/GeoIPCity.dat

After this configuration is completed, contact technical support at Renegade Internet and ask them to enable GeoIP City for your license key. Do not do this until you have uploaded the GeoIP database and edited the maxmind.properties 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 City 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 City 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.

Troubleshooting

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.