| Div | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Islandora utilizes the Solr open source search platform to enable flexible and configurable indexing and searching. Solr uses the Lucene Java search library at its core for full-text indexing and search and offers hit highlighting, faceted search, dynamic clustering, database integration, and rich document (e.g., Word, PDF) handling as additional features.
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.
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.
The Islandora Solr Search module is packaged with files that will support Islandora solution packs, but these can be modified if you are familiar with Solr. Specifically the Solr schema and corresponding Gsearch XSLT are a good starting point even if you do not use the Solr Search module. Additional information about Solr is presented in Chapter 4: Search and Discovery in Islandora (The Solr Module).
While Solr is not required to run Islandora, it is recommended.
1. Download fedoraGSearch from SourceForge.net and extract the contents of the compressed file. Copy the file fedoragsearch.war to the webapps folder.
| Code Block |
|---|
cp ~/fedoragsearch.war $FEDORA_HOME/tomcat/webapps/ |
2. Download Solr to your local environment and unpack the downloaded file.
3. Create a directory for Solr. These instructions presume that it will be installed at ~/opt/solr:
| Code Block |
|---|
mkdir -p /opt/solr |
4. Drag or mv the .war file that is located under the dist directory of your unpacked download to the newly created /opt/solr directory.
5. Copy the directory apache-solr-x.x.x/example/solr to $FEDORA_HOME/solr and /exmaple/webapps/solr.war to $FEDORA_HOME/tomcat/webapps
| Code Block |
|---|
cp -r apache-solr-x.x.x/example/solr $FEDORA_HOME/solr cp apache-solr-x.x.x/example/webapps/solr.war $FEDORA_HOME/tomcat/webapps/ |
6. Edit the file $FEDORA_HOME/server/config/fedora-users.xml to add an additional user:
| Code Block |
|---|
<user name="fgsAdmin" password="[password]">
<attribute name="fedoraRole">
<value>administrator</value>
</attribute>
</user> |
7. Edit the file $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/fgsconfig-basic.properties
| Code Block |
|---|
configDisplayName=configProductionOnSolr
gsearchPass= [password]
local.FEDORA_HOME=/usr/local/fedora
namesOfRepositories=FgsRepos
namesOfIndexes=FgsIndex
[keep name in order not to modify GUI for GSearch]
fedoraBase=http://localhost:8080
[to access objects from index in GUI for GSearch]
fedoraPass=[password]
indexEngine=Solr
indexBase=http://localhost:8080/solr
indexDir=${local.FEDORA_HOME}/solr/data/index
indexingDocXslt=foxmlToSolr |
| Note |
|---|
Gsearch properties files are sensitive. A space after the text at the end of a line may cause that entry to fail. |
8. Navigate to $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/and run Apache ant on fgsconfig-basic.xml
| Code Block |
|---|
cd $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/ ant -f fgsconfig-basic.xml |
9. Rename the current Solr schema.xml file to schema.bak
| Code Block |
|---|
mv $FEDORA_HOME/solr/conf/schema.xml $FEDORA_HOME/solr/conf/schema.bak |
10. Copy the new, ant-generated Solr schema into place as schema.xml
| Code Block |
|---|
cp $FEDORA_HOME/tomcat/webapps/fedoragsearch/WEB-INF/classes/fgsconfigFinal/index/FgsIndex/conf/schema-x.x.x-for-fgs-x.x.xml $FEDORA_HOME/solr/conf/schema.xml |
11. Restart Fedora.
| Code Block |
|---|
$FEDORA_HOME/tomcat/bin/shutdown.sh $FEDORA_HOME/tomcat/bin/startup.sh |
12. Test your installation by going to http://localhost:8080/fedoragsearch/rest
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 Chapter 4 - Search and Discovery in Islandora (The Solr Module).
Installation Steps: