Difference between revisions of "SUNScholar/SOLR Statistics"

From Libopedia
Jump to navigation Jump to search
m
 
(9 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
  '''[[SUNScholar/Statistics|Back to Statistics]]'''
 
  '''[[SUNScholar/Statistics|Back to Statistics]]'''
 
</center>
 
</center>
 +
 +
==Introduction==
 +
SOLR Statistics was introduced with DSpace =>1.6.2. SOLR statistics are now enabled by default for the XMLUI in DSpace versions =>3.2.
 +
==Instructions==
 +
===[[SUNScholar/Statistics/5.X|For DSpace 5.X]]===
 +
===[[SUNScholar/Statistics/4.X|For DSpace 4.X]]===
 +
 +
==[[SUNScholar/Statistics/Old Versions|Old Statistics Conversion Help]]==
  
 
==<font color="red">'''PLEASE NOTE:'''</font>==
 
==<font color="red">'''PLEASE NOTE:'''</font>==
===When upgrading===
+
===Step 1 - Optimise statistics database===
''Before upgrading to DSpace 3.2, run SOLR statistics optimisation '''$HOME/bin/dspace stats-util -o''' at least once just before the upgrade!''
+
''Before upgrading DSpace, run SOLR statistics optimisation '''$HOME/bin/dspace stats-util -o''' at least once just before the upgrade!''
===Backup SOLR database===
+
===Step 2 - Backup statistics database===
 
<font color="red">'''If you are upgrading, you need to backup the SOLR database before doing any new configuration.'''</font>
 
<font color="red">'''If you are upgrading, you need to backup the SOLR database before doing any new configuration.'''</font>
  
Line 17: Line 25:
  
 
  sudo service tomcat7 start
 
  sudo service tomcat7 start
===New SOLR database fields===
+
===Step 3 - Adding new SOLR statistics database fields===
 
New statistics fields were introduced in DSpace 4.X, therefore any upgrade from a DSpace version <= 3.X will not have these fields.
 
New statistics fields were introduced in DSpace 4.X, therefore any upgrade from a DSpace version <= 3.X will not have these fields.
  
Line 31: Line 39:
 
*https://github.com/DSpace/DSpace/pull/905
 
*https://github.com/DSpace/DSpace/pull/905
  
==Introduction==
 
SOLR Statistics was introduced with DSpace =>1.6.2. SOLR statistics are now enabled by default for the XMLUI in DSpace versions =>3.2.
 
 
===[[SUNScholar/Statistics/5.X|For DSpace 5.X]]===
 
===[[SUNScholar/Statistics/4.X|For DSpace 4.X]]===
 
===[[SUNScholar/Statistics/3.X|For DSpace 3.X]]===
 
==[[SUNScholar/Statistics/Old Versions|Old Statistics Conversion Help]]==
 
 
==References==
 
==References==
 
*https://wiki.duraspace.org/display/DSDOC5x/SOLR+Statistics
 
*https://wiki.duraspace.org/display/DSDOC5x/SOLR+Statistics
Line 47: Line 48:
 
*https://wiki.duraspace.org/display/DSDOC3x/DSpace+Statistics
 
*https://wiki.duraspace.org/display/DSDOC3x/DSpace+Statistics
 
*https://wiki.duraspace.org/display/DSDOC3x/Managing+Usage+Statistics
 
*https://wiki.duraspace.org/display/DSDOC3x/Managing+Usage+Statistics
 +
[[Category:Customisation]]

Latest revision as of 16:48, 25 November 2016

Back to Statistics

Introduction

SOLR Statistics was introduced with DSpace =>1.6.2. SOLR statistics are now enabled by default for the XMLUI in DSpace versions =>3.2.

Instructions

For DSpace 5.X

For DSpace 4.X

Old Statistics Conversion Help

PLEASE NOTE:

Step 1 - Optimise statistics database

Before upgrading DSpace, run SOLR statistics optimisation $HOME/bin/dspace stats-util -o at least once just before the upgrade!

Step 2 - Backup statistics database

If you are upgrading, you need to backup the SOLR database before doing any new configuration.

Type the following to backup the SOLR DB: (If using Ubuntu 12.04 LTS, replace tomcat7 with tomcat6)

sudo service tomcat7 stop
mkdir backup
cp -Rv $HOME/solr/ $HOME/backup/
sudo service tomcat7 start

Step 3 - Adding new SOLR statistics database fields

New statistics fields were introduced in DSpace 4.X, therefore any upgrade from a DSpace version <= 3.X will not have these fields.

The lack of these new fields in statistics records from previous versions of DSpace, causes major errors when attempting to do statistics maintenance in DSpace versions => 4.X after an upgrade from a lower version of DSpace. See the link below for a possible fix.

https://gist.github.com/terrywbrady/82bd91b53ea4374b96e4

Because of this problem, we are considering using Elastic Statistics exclusively instead, which seems to be more stable and provides download data not just visits and views.

The issue is being discussed on this wiki page: https://wiki.duraspace.org/display/DSPACE/DSpace+statistics+-+current+status+and+future+development

Also see the following about work to automatically fix old statistics databases.

References