After purchasing the MaxMind GeoIP Country database from MaxMind, follow these steps to download the correct database package:
There is also a free version of GeoIP Country that you can download for evaluation purposes, but you should bear in mind that it is not as accurate as the paid version!
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/maxmind.properties file to enter the path to the GeoIPCountry.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/GeoIPCountry.dat
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 maxmind.properties configuration file! Doing so will result in the GeoIP module failing to load and abort startup.
In order for AdvertPRO to load your newly installed MaxMind Country module, you will need to restart your application server.
That's it. Congratulations, you've successfully installed the MaxMind Country module!
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.