Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Fedora Generic Search Service, or GSearch, is a search service installed with Fedora that allows for automatic updating of the Lucene/Solr index. GSearch relies on JMS to receive messages that are sent when Fedora objects are ingested, modified or purged. This keeps the Lucene index in sync with the Fedora repository.

How Islandora uses Solr/Lucene and Gsearch

Islandora makes it possible to use the power of Solr/Lucene for discovery. Gsearch is used as a method for keeping indexes current. When an item is ingested, the FOXML is transformed by an XSLT file stored in Gsearch into a format that can be read by Solr's schema and returned based on the request handlers in our custom solrconfig.xml.

...

While Solr is not required to run Islandora, it is recommended.

Installing Solr and GSearch

1. Download GSearch 2.7, unzip and copy fedoragsearch.war to the Tomcat webapps folder ($CATALINA_HOME/webapps).

...

Code Block
languagebash
# /usr/local/fedora/tomcat/bin/shutdown.sh
# /usr/local/fedora/tomcat/bin/startup.sh

 Test your GSearch installation

...

Note

GSearch and Solr may need to be further configured to index specific datastreams, depending on the enhancement modules you install. Sample GSearch and Solr configurations can be found here and here.

Installing & Configuring the Solr Search Module

The Islandora Solr search module allows you to search the Solr index.  The Islandora Solr Sample Configuration module provides default display profiles to the module. The module makes four new blocks available; two for search and two for display.  The other block is called the Advanced Search Block and does fielded searches against the Solr index.  Both blocks would use whatever request handler is configured in the module settings. For information on how to configure the Solr module, see Islandora Solr Search.

...

  1. Verify that fedoraGSearch and Solr are both installed and running.
    Go to http://localhost:8080/solr
  2. Solr does not automatically load existing content upon installation. Go to Core Admin -> Reload tab
  3. Download the Islandora Solr Search Module and install as a Drupal module, as you did in the Starter Kit modules
  4. Log in to your Drupal site to enable the islandora_solr_search module. Administer > Modules and enable Islandora Solr Search
  5. Access the [Structure]:[Blocks] tab, go to the bottom of the blocks list in the Disabled section, find the "+ Islandora simple search" block and drag it up to the Sidebar first section.
  6. Replace the original Drupal search block with the one from Islandora on the sidebar
  7. You should now be able to see the Islandora search box in the on the sidebar. 


Testing the Solr installation

Just entry a keyword in the Islandora search field related to some of the test objects you ingest in the Starter Kit collections. If they come up on the list everything is working as it should

...