Date: Thu, 28 Mar 2024 17:32:56 -0400 (EDT) Message-ID: <813501553.28982.1711661576689@lyrasis1-roc-mp1> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_28981_1669935070.1711661576688" ------=_Part_28981_1669935070.1711661576688 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Islandora utilizes the Solr open source search platform to enabl= e flexible and configurable indexing and searching. Solr uses the Lucene Java search library at its core for full-text indexing and sear= ch and offers hit highlighting, faceted search, dynamic clustering, databas= e integration, and rich document (e.g., Word, PDF) handling as additional f= eatures.
The Fedora Generic Search Service, or GSearch, is a search service insta= lled with Fedora that allows for automatic updating of the Lucene/Solr inde= x. GSearch relies on JMS to receive messages that are sent when Fedora obje= cts are ingested, modified or purged. This keeps the Lucene index in sync w= ith the Fedora repository.
Islandora makes it possible to use the power of Solr/Lucene for discover= y. 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 reques= t handlers in our custom solrconfig.xml.
The Islandora Solr Search module is packaged with files that will suppor= t Islandora solution packs, but these can be modified if you are familiar w= ith Solr. Specifically the Solr schema and corresponding Gsearch XSLT= are a good starting point even if you do not use the Solr Search module.&n= bsp; Additional information about Solr is presented in Chapter 4: Search an= d 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 conte= nts of the compressed file. Copy the file fedoragsearch.war to the webapps = folder.
cp ~/fe= doragsearch.war $FEDORA_HOME/tomcat/webapps/
2. Download Solr to your local environme= nt and unpack the downloaded file.
3. Create a directory for Solr. These instructions presume that it will = be installed at ~/opt/solr:
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.= p>
5. Copy the directory apache-solr-x.x.x/example/solr to $FEDORA_HOME/sol= r and /exmaple/webapps/solr.war to $FEDORA_HOME/tomcat/webapps
cp -r a= pache-solr-x.x.x/example/solr $FEDORA_HOME/solr cp apache-solr-x.x.x/example/webapps/solr.war $FEDORA_HOME/tomcat/webapps/<= /pre>
6. Edit the file $FEDORA_HOME/server/config/fedora-users.xml to add an additional u= ser:
<use= r name=3D"fgsAdmin" password=3D"[password]"> <attribute name=3D"fedoraRole"> <value>administrator</value> </attribute> </user>
7. Edit the file $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/fgsconfig-basic.prope= rties
configD= isplayName=3DconfigProductionOnSolr gsearchPass=3D [password] local.FEDORA_HOME=3D/usr/local/fedora namesOfRepositories=3DFgsRepos namesOfIndexes=3DFgsIndex [keep name in order not to modify GUI for GSearch] fedoraBase=3Dhttp://localhost:8080 [to access objects from index in GUI for GSearch] fedoraPass=3D[password] indexEngine=3DSolr indexBase=3Dhttp://localhost:8080/solr indexDir=3D${local.FEDORA_HOME}/solr/data/index indexingDocXslt=3DfoxmlToSolr
Gsearch propert= ies 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 a= nt on fgsconfig-basic.xml
cd $FED= ORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/ ant -f fgsconfig-basic.xml
9. Rename the current Solr schema.xml file to schema.bak
mv $FED= ORA_HOME/solr/conf/schema.xml $FEDORA_HOME/solr/conf/schema.bak
10. Copy the new, ant-generated Solr schema into place as schema.x= ml
cp $FED= ORA_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.xm= l
11. Restart Fedora.
$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.&nb= sp; The Islandora Solr Sample Configuration module provides default display= profiles to the module. The module makes four new blocks available; two fo= r search and two for display. The other block is called the Advan= ced Search Block and does fielded searches against the Solr index.&nbs= p; Both blocks would use whatever request handler is configured in the modu= le settings. For information on how to configure the Solr module, see Chapter 4 - Search and Discovery in Islandora= (The Solr Module).
Installation Steps: