Managing the MaxMind GeoIP2 Plugin.

The Revive Adserver "MaxMind GeoIP2" plugin offers a number of options that can be configured via the plugin management page.

To access the plugin configuration page, as an administrator user, go to Configuration > Plugins, and then select the Details link for the MaxMind GeoIP2 Plugin:

Next, click on the Settings link.

From here, you can:

• Add additional MaxMind GeoIP2 database files to be used for geotargeting by supplying the location of each file you want to use per line in the appropriate box; and
• Set up your MaxMind GeoIP2 license key.

Enable Geotargeting

Once these settings for the MaxMind GeoIP2 plugin have been configured, don't forget to enable (switch on) the Geotargeting feature.

Managing MaxMind GeoIP2 file updates outside of Revive Adserver

The geotargeting plugin that ships with Revive Adserver v5.0.x and higher will automatically download and use the required datafile(s) from the MaxMind webserver at the time of installation, or when upgrading an existing installation that used an older version of the software. Specifically, it will download the compressed file "GeoLite2-City.tar.gz" and extract the file "GeoLite2-City.mmdb" contained in it. It will also store an md5 checksum of the mmdb file, so that it can check for future updates of it.

The geotargeting plugin also checks every night during the midnight maintenance run if a newer version of the MaxMind data file is available from MaxMind's webserver. If so, it will download that automatically and use it to update the file it stored before, and also a new md5 checksum.

The geotargeting plugin adds a section to the configuration file with an entry where a system administrator can specify another location for the datafile(s), in case there is an alternative process already being used to retrieve and update said files. By default, the section looks like this:

[rvMaxMindGeoIP2]
mmdb_paths=

Here is an example of how it could be altered to reference a file somewhere else on the server:

[rvMaxMindGeoIP2]
mmdb_paths="/{path}/GeoLite2-City.mmdb"

With this in place, the Revive Adserver software will no longer attempt to update the file at regular intervals, as it is assumed that the file is being updated by some other process.