Version 5.0

AdvertPro + MaxMind GeoIP Country Integration

Downloading

After purchasing a subscription for the MaxMind GeoIP Country database from MaxMind, follow these steps to install GeoIP Country and set it up for automatic updates:

  1. Login to to your MaxMind account.
  2. Click on the Automatic Updates link in the menu on the left side of the page.
  3. Follow their instructions to download, install and configure the GeoIP Update software.

After completing the installation you should have the GeoIP Country database installed at /usr/local/share/GeoIP/GeoIP.dat and it will be updated automatically every week.

Configuration

At this point, if you have not set AdvertPro up yet you can skip the rest of these instructions and instead proceed to run its setup utility.

If you have already run the AdvertPro setup, you will need to edit the /usr/local/tomcat/webapps/ROOT/config/maxmind.properties file and enter the path to the GeoIP.dat file.

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=/usr/local/share/GeoIP/GeoIP.dat
CACHE=0

After this configuration is completed, contact technical support at Renegade Internet and ask them to enable the GeoIP Country module for your license key.

Finishing Up

In order for AdvertPro to load and activate the GeoIP Country module, you will need to restart Tomcat.


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

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

Note Note

Tomcat 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 /usr/local/tomcat/webapps/ROOT/logs/error_log_YYYY-MM-DD file to assist you with troubleshooting.