Versions Compared

Old Version 2

changes.mady.by.user Mark H. Wood

Saved on

compared with

New Version 3

changes.mady.by.user Tim Donohue

Saved on

Key

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

...

Code Block
<lst name="facet_counts">
    <lst name="facet_fields">
        <lst name="epersonid">
            <int name="66">1167</int>

<int name="117">251</int>

<int name="52">42</int>

<int name="19">36</int>

<int name="88">20</int>

<int name="112">18</int>

<int name="110">9</int>

<int name="96">0</int>

</lst>
    </lst>
</lst>

Managing the

...

City Database File

Info

As of DSpace 6.3, this file changed names. In DSpace 6.2 or below, it was named GeoLiteCity.dat. If you still have an old GeoLiteCity.dat file, you can now remove it. The new file is named GeoLite2-City.mmdb

The GeoLite Database file (at [dspace]/config/GeoLite2-City.mmdb) is used by the Statistics engine to generate location/country based reports.  It is not provided with DSpace; you will need to manually install it. (Note: If you are not using DSpace Statistics, this file is not needed.)  See the provider's web site for more information about this file, and to get a free account for downloading it.

Alternatively, DSpace can be configured to use a GeoLite City database file that you already have and maintain by other means.  You can edit [dspace]/config/local.cfg (or [dspace]/config/modules/usage-statistics.cfg), changing the path usage-statistics.dbfile to point to a shared copy of the database.

This file is frequently updated by MaxMind.com, so you will need to refresh it regularly.  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.

...

If you wish to record the geographic locations of clients in your DSpace statistics records (e.g. the City or Country where they are accessing your DSpace), you must install (and regularly update) one of the following IP to City Database Files (in MMDB format).  We recommend installing a City-level database, as it provides more granular location information than a Country-level database (which can only provide the country where the access originated).

  • 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 manager.  You will still need to configure your license key prior to usage.
    • 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.
    • This file is frequently updated by MaxMind.com, so you will need to refresh it regularly.  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.
    • 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. 
    • This file is frequently updated by DB-IP.com, so you will need to refresh it regularly. As this is written, the database is updated monthly with the latest available at https://db-ip.com/db/download/ip-to-city-lite