Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated Discovery howto, includes patch, instead of step-by-step file to patch instruction. Also with pictures

Wiki Markup
*Howto: Use DSpace Discovery*   
The Discovery Module enables your repository to have faceted searching.  
Thus a user can filter what they are looking for by grouping entries into a facet, and drill down to find the content they are interested in.  
So instead of user searching: \[ wetland + "dc.author=Mitsch, William J" + dc.subject="water quality" \], they can instead do their initial search, \[ wetland \], and then filter the results by attributes. 
!worddava7d46df6db45f7ce78511e9f8e78b098.png|height=855,width=804! 

A website like Amazon, might do this to help you select a digital camera. You can reduce the results by price range, features, megapixels, manufacturer, etc.
The further the DSpace Discovery module is developed, the more useful that browsing can be to the researcher looking for items in your collections.

Checkout the projects source

  1. A Fresh Copy of the DSpace Trunk
    Code Block
    svn checkout {+}http
    
    svn checkout http://scm.dspace.org/svn/repo/dspace/trunk/
    +Image Removed
     dspace-trunk 
    
  2. The Discovery Modulesvn checkout Module
    Code Block
    
    svn checkout http://scm.dspace.org/svn/repo/modules/dspace-discovery/trunk/
    Image Removed
     dspace-discovery   
    

Reference
For reference, look at the Dryad project 

...

 as that is using the discovery layer.

...

Overview
Have both projects checked out to the same root projects folder. You will not have to modify dspace-discovery at all, but the patch will enable the dspace-trunk to use some features of dspace services, and include other libraries such as org.apache.solr that are needed.
The discovery module essentially adds an additional core to solr. Existing was statistics, the new core is search. 

Obtain the patch

To patch: 

Code Block

cd /path/to/project/dspace-trunk/dspace

...

 
patch -p1 < /path/to/discovery-applied-to-dspace-trunk.patch 

If you name discovery-trunk anything other than that, you will have to modify dspace-trunk/dspace/pom.xml accordingly.
Then the regular rebuild process applies. It may be necessary to do a mvn clean package.

In config/dspace-solr-search.cfg and dspace.cfg is a setting for:

Code Block

solr.search.server = http://127.0.0.1:8080/solr

...

 

Adjust that if necessary.
After the patch, you will need to set solr/home. Modify /dspace/webapps/solr/WEB-INF/web.xml to use your solr/home. 

Code Block

    <env-entry>

...

 
       <env-entry-name>solr/home</env-entry-name>

...

 
       <env-entry-value>/dspace/solr</env-entry-value>

...

 
       <env-entry-type>java.lang.String</env-entry-type>

...

 
    </env-entry> 

Once Wiki MarkupOnce you've restarted your \ {tomcat\} server, and SOLR is up and running, you'll need to index your content.

Code Block

...

[/dspace/bin/

...

] ./dspace update-discovery-index 
  • unmigrated-wikior -markup
    or - Once, [<span style="color: #0000ff">{+}<span class="nobr"><a href="http://jira.dspace.org/jira/browse/DS-516+" class="external-link" rel="nofollow">http://jira.dspace.org/jira/browse/DS-516+<sup><img class="rendericon" src="/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></span>|http://jira.dspace.org/jira/browse/DS-516] is committed it can be invoked by:
    Code Block
     
    \[/dspace/bin/\] ./dspace dsrun org.dspace.discovery.IndexClient   *Screenshots* 
    Empty search shows that it can be filtered easily. 
    !worddave0432a807dfbee0a0920d684f5c5e9e5.png|height=843,width=858! 
    

Screenshots
Empty search shows that it can be filtered easily.
Image Added