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)
    • NOTE: 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 may download GeoLite2 directly from MaxMind, or many Linux distributions provide the geoipupdate tool directly via their package managerwill need to arrange regular downloads of the GeoLite2 database.  MaxMind offers an updater tool 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 .  As this is (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.
    • The file is obtained/updated using MaxMind's geoipupdate tool.  Find it here.  Many Linux distributions also re-package geoipupdate, so you may prefer to get it using your package manager.
  • 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 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

...