SUNScholar/Asset Statistics
This wiki page relates to the system build and maintenance of: http://scholar.sun.ac.za
Contents |
Introduction
This/These procedure/s assume/s that you have used the three step process to install an Ubuntu server with DSpace software.
Individual item statistics using Apache SOLR was introduced with DSpace version 1.6.2.
Below are instructions to setup SOLR statistics for DSpace versions => 1.6.2
Before attempting SOLR statistics setup please make sure the following are correct:
Step 1. Update SOLR DSpace statistics config
SOLR server port configuration
Edit the DSpace config file by typing the following.
nano /home/dspace/dspace-1.8.2-src-release/dspace/config/modules/solr-statistics.cfg
Remove the port 8080 reference, see example below.
#---------------------------------------------------------------#
#--------------SOLR STATISTICS CONFIGURATIONS-------------------#
#---------------------------------------------------------------#
# These configs are only used by the SOLR interface/webapp to #
# track usage statistics. #
#---------------------------------------------------------------#
##### Usage Logging #####
# set this to be the port you run the dspace "solr" webapp
# on, by default, we are assuming a test configuration with
# tomcat still running on port 8080
server = http://localhost/solr/statistics
# The location for the Geo Database retrieved on update/installation
dbfile = /home/dspace/config/GeoLiteCity.dat
# Timeout for the resolver in the dns lookup
# Time in milliseconds, defaults to 200 for backward compatibility
# Your systems default is usually set in /etc/resolv.conf and varies
# between 2 to 5 seconds, to high a value might result in solr exhausting
# your connection pool
resolver.timeout = 500
# Control if the statistics pages should be only shown to authorized users
# If enabled, only the administrators for the DSpaceObject will be able to
# view the statistics.
# If disabled, anyone with READ permissions on the DSpaceObject will be able
# to view the statistics.
authorization.admin=false
# A comma seperated list that contains the bundles for which the bitstreams will be displayed
query.filter.bundles=ORIGINAL
# Enable/disable logging of spiders in solr statistics.
# If false, and IP matches an address in spiderips.urls, event is not logged.
# If true, event will be logged with the 'isBot' field set to true
# (see query.filter.* for query filter options)
# Default value is true.
logBots = false
# control solr statistics querying to filter out spider IPs
# false by default
#query.filter.spiderIp = false
# control solr statistics querying to look at "isBot" field to determine
# if record is a bot. true by default.
#query.filter.isBot = true
# URLs to download IP addresses of search engine spiders from
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, \
Step 2. Ensure that the statistics aspect is enabled
Edit the xmlui.xconf config file and enable the statistics aspect. Read all the comments in the config file.
Step 3. Update daily cron job
Go to: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Daily_Admin and enable stats-utils jobs.
References
- https://wiki.duraspace.org/display/DSDOC3x/DSpace+Statistics
- https://wiki.duraspace.org/display/DSDOC18/DSpace+Statistics
- https://wiki.duraspace.org/display/DSDOC17/DSpace+Statistics
- http://www.dspace.org/1_6_2Documentation/ch03.html#N10CF2
Old Statistics Conversion Help
Check SOLR webapp operation
If you have problems with the SOLR webapp, then complete the following to check its operation.
Install the "lynx" application.
sudo apt-get install lynx
Then type the following in the console:
lynx http://localhost/solr
OR
lynx http://localhost:8080/solr
You should get the following:
If not debug the solr webapp until you can.
Remember to restart the Tomcat server for each change you make to a webapp configuration.
Command Line Help
Go to: http://www.ubuntu.sun.ac.za/wiki/index.php/SelfHelp for more help about the command line programs used in this procedure.
Back to Indexes
