Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Moving the 'GeoLite update' section out of the general installation instructions into the Statistics configuration section

...

  1. DSpace Configuration for Accessing Solr. In the dspace.cfg file review the following fields to make sure they are uncommented:
    Code Block
    solr.log.server = ${dspace.baseUrl}/solr/statistics
    solr.dbfile = ${dspace.dir}/config/GeoLiteCity.dat
    solr.spiderips.urls = http://iplists.com/google.txt, \
                          http://iplists.com/inktomi.txt, \
                          http://iplists.com/lycos.txt, \
                          http://iplists.com/infoseek.txt, \
                          http://iplists.com/altavista.txt, \
                          http://iplists.com/excite.txt, \
                          http://iplists.com/misc.txt, \
                          http://iplists.com/non_engines.txt
  2. DSpace logging configuration for Solr. If your DSpace instance is protected by a proxy server, in order for Solr to log the correct IP address of the user rather than of the proxy, it must be configured to look for the X-Forwarded-For header.  This feature can be enabled by ensuring the following setting is uncommented in the logging section of dspace.cfg:
    Code Block
    useProxies = true
  3. Configuration Control. In the dspace.cfg set the following property key:_statistics.item.authorization.admin=true_This will require the user to sign on to see that statistics. Setting the statistics to "false" will make them publicly available.
  4. Final steps.
    • Perform the following step:
      Code Block
      cd [dspace-source]/dspace
      mvn package
      cd [dspace-source]/dspace/target/dspace-<version>-build
      ant -Dconfig=[dspace]/config/dspace.cfg update
      cp -R [dspace]/webapps/* [TOMCAT]/webapps
      
      Wiki Markup
      If you only need to build the statistics, and don't make any changes to other web applications, you can replace the copy step above with: _cp \-R \[dspace\]/webapps/solr \[TOMCAT\]/webapps_
    • Restart your webapps (Tomcat/Jetty/Resin)

Manually Installing/Updating GeoLite Database File

Wiki Markup
The GeoLite Database file (at \[dspace\]/config/GeoLiteCity.dat) is used by the [DSpace Statistics|#DSpace Statistics] engine to generate location/country based reports. (_Note: If you are not using DSpace Statistics, this file is not needed._)

In most cases, this file is installed automatically when you run ant fresh_install. However, if the file cannot be downloaded & installed automatically, you may need to manually install it.

As this file is also sometimes updated by MaxMind.com, you may also wish to update it on occasion.

You have two options to install/update this file:

  1. Wiki Markup
    Attempt to re-run the automatic installer from your DSpace Source Directory (\[dspace-source\]). This will attempt to automatically download the database file, unzip it and install it into the proper location:
    Code Block
    ant update_geolite
    • Wiki Markup
      NOTE: If the location of the GeoLite Database file is known to have changed, you can also run this auto-installer by passing it the new URL of the GeoLite Database File: {{ant \-Dgeolite=\[full-URL-of-geolite\] update_geolite}}
  2. OR, you can manually install the file by performing these steps yourself:

Windows Installation

Pre-requisite Software

...