All Versions
- DSpace 7.x (Current Release)
- DSpace 8.x (Unreleased)
- DSpace 6.x (EOL)
- DSpace 5.x (EOL)
- More Versions...
Unsupported Release
This documentation relates to an old, unsupported version of DSpace, version 1.7.x. Looking for another version? See all documentation.
As of January 2014, the DSpace 1.7.x platform is no longer supported. We recommend upgrading to a more recent version of DSpace.
DSpace uses the Apache Solr application underlaying the statistics. There is no need to download any separate software. All the necessary software is included.
The DSpace Statistics Implementation is a Client/Server architecture based on Solr for collecting usage events in the JSPUI and XMLUI user interface applications of DSpace. Solr runs as a separate webapplication and an instance of Apache Http Client is utilized to allow parallel requests to log statistics events into this Solr instance. The Usage Event framework has a couple EventListeners installed which assist in
In the dspace.cfg file review the following fields to make sure they are uncommented:
Property Name |
Default Value |
Type |
Description |
||||||
---|---|---|---|---|---|---|---|---|---|
solr.log.server |
$ Unknown macro: {dspace.baseUrl}
/solr/statistics |
String |
Is used by the SolrLogger Client class to connect tot the Solr server over http and perform updates and queries. In most cases, this can (and should) be set to localhost. |
||||||
solr.spiderips.urls |
http://iplists.com/google.txt , \ , \ , \ , \ , \ , \ , \
Unknown macro: {margin}
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 |
String |
List of URLs to download spiders files into [dspace]/config/spiders. These files contain lists of known spider IPs and are utilized by the SolrLogger to flag usage events with an "isBot" field, or ignore them entirely. dspace stats-util -h from your [dspace]/bin directory |
||||||
solr.dbfile |
$ Unknown macro: {dspace.dir}
/config/GeoLiteCity.dat | String
Upgrade Process for Statistics.Example of rebuild and redeploy DSpace (only if you have configured your distribution in this manner) First approach the traditional DSpace build process for updating cd [dspace-source]/dspace mvn package cd [dspace-source]/dspace/target/dspace-<version>-build.dir ant -Dconfig=[dspace]/config/dspace.cfg update cp -R [dspace]/webapps/* [TOMCAT]/webapps The last step is only used if you are not mounting [~mdiggory:dspace]/webapps directly into your Tomcat, Resin or Jetty host (the recommended practice)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 Again, only if you are not mounting [~mdiggory:dspace]/webapps directly into your Tomcat, Resin or Jetty host (the recommended practice) Restart your webapps (Tomcat/Jetty/Resin) Older setting that are no currently utilized in the reportsAre the following Dspace.cfg fields still used by the new 1.6 Statistics? If not, we need to either document this well or remove them altogether:
/reports/ |
These fields are not used by the new 1.6 Statistics, but are only related to the Statistics from previous DSpace releases