Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Either install a copy of MaxMind's GeoLite City database (in MMDB format)
    • Installing MaxMind GeoLite2 is free.  However, you must sign up for a (free) MaxMind account in order to obtain a license key to use the GeoLite2 database.
    • You will need to arrange regular downloads of the GeoLite2 database.  MaxMind offers an updater tool (geoipupdate) to do the downloading/updating, and a number of Linux distributions package it (as geoipupdate).  You will still need to configure your license key prior to usage. Use it before restarting DSpace, to get an up-to-date database.
    • Once the "GeoLite2-City.mmdb" database file is installed on your system,  you will need to configure its location as the value of usage-statistics.dbfile in your local.cfg configuration file.
    • NOTE: This file is frequently updated by MaxMind.com, so you will need to refresh it regularly (ideally by scheduling the updater tool via a cron job or similar).  As this is written, the database is updated monthly, and to be allowed to obtain it you need to agree to keep your copy updated.
  • Or, you can alternatively use/install DB-IP's City Lite database (in MMDB format)
    • This database is also free to use, but does not require an account to download.
    • You will need to arrange regular downloads of the City Lite database.  DB-IP offers an updater tool to (dbip-update) to do the downloading/updating, but it requires PHP to run.
    • Once the "dbip-city-lite.mmdb" database file is installed on your system,  you will need to configure its location as the value of usage-statistics.dbfile in your local.cfg configuration file
    • NOTE: This file is frequently updated by DB-IP.com, so you will need to refresh it regularly (ideally by scheduling the updater tool via a cron job or similar). As this is written, the database is updated monthly with the latest available at https://db-ip.com/db/download/ip-to-city-lite

...