Page History

...

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).

...

$ unzip fedoragsearch-2.6.zip
$ cd fedoragsearch-2.6.zip
$ cp -v fedoragsearch.war /usr/local/fedora/tomcat/webapps

...

$ mkdir -p /usr/local/fedora/solr
$ cp -Rv solr-4.2.0/example/solr/* /usr/local/fedora/solr

4. Copy (and rename) solr-4.2.0.war to $CATALINA_HOME/webapps.

$ cp -v solr-4.2.0/dist/solr-4.2.0.war /usr/local/fedora/tomcat/webapps/solr.war

5. Edit the file $FEDORA_HOME/server/config/fedora-users.xml to add an additional user:

<user name="fgsAdmin" password="[password]">
   <attribute name="fedoraRole">
     <value>administrator</value>
   </attribute>
  </user>

6. Restart Fedora to deploy GSearch and Solr

$ /usr/local/fedora/tomcat/bin/shutdown.sh

$ /usr/local/fedora/tomcat/bin/startup.sh

7. Edit the file $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/fgsconfig-basic-for-islandora.properties. The entries below are of an example setup.

configDisplayName=configProductionSolr
gsearchBase=http://localhost:8080
gsearchAppName=fedoragsearch
 
gsearchUser=fgsAdmin
gsearchPass=[password]
finalConfigPath=/usr/local/fedora/tomcat/webapps/fedoragsearch/WEB-INF/classes
 
logFilePath=${local.FEDORA_HOME}/usr/local/fedora/server/logs
logLevel=DEBUG
namesOfRepositories=FgsRepos
 
namesOfIndexes=FgsIndex
fedoraBase=http://localhost:8080
fedoraAppName=fedora
 
fedoraUser=fedoraAdmin
fedoraPass=[password]
fedoraVersion=3.7.0
 
objectStoreBase=${local.FEDORA_HOME}/usr/local/fedora/data/objectStore
indexEngine=Solr
indexBase=http://localhost:8080/solr
 
indexDir=${local.FEDORA_HOME}/usr/local/fedora/solr/collection1/data/index
indexingDocXslt=foxmlToSolr

87. Edit $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/fgsconfig-basic.xml (replace 'fgsconfig-basic.properties' with 'fgsconfig-basic-for-islandora.properties'):

-- <property file="fgsconfig-basic.properties" />
-- <copy file="fgsconfig-basic.properties" tofile="fgsconfig-basic-${configDisplayName}.properties" preservelastmodified="true" />
-- <copy file="fgsconfig-basic.properties" tofile="${templateConfigPath}/${configDisplayName}/${finalConfigName}/fgsconfig-basic-${configDisplayName}.properties" preservelastmodified="true" />


++ <property file="fgsconfig-basic-for-islandora.properties" />
++ <copy file="fgsconfig-basic-for-islandora.properties" tofile="fgsconfig-basic-${configDisplayName}.properties" preservelastmodified="true" />
++ <copy file="fgsconfig-basic-for-islandora.properties" tofile="${templateConfigPath}/${configDisplayName}/${finalConfigName}/fgsconfig-basic-${configDisplayName}.properties" preservelastmodified="true" />

89. Navigate to $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/and run Apache ant on fgsconfig-basic.xml

$ cd $FEDORA_HOME/usr/local/fedora/tomcat/webapps/fedoragsearch/FgsConfig/
$ ant -f fgsconfig-basic.xml

910. Rename the current Solr schema.xml file to schema.bak

$ mv -v $FEDORA_HOME/usr/local/fedora/solr/collection1/conf/schema.xml $FEDORA_HOME/solr/collection1/conf/schema.bak

1011.  Copy the new, ant-generated Solr schema into place as schema.xml

$ cp -v $FEDORA_HOME/usr/local/fedora/tomcat/webapps/fedoragsearch/WEB-INF/classes/fgsconfigFinal/index/FgsIndex/conf/schema-4.2.0-for-fgs-2.6.xml $FEDORA_HOME/solr/collection1/conf/schema.xml

12. Create a context file for Solr at /usr/local/fedora/tomcat/conf/Catalina/localhost/solr.xml

<?xml version="1.0" encoding="UTF-8"?>
<Context docBase="/usr/local/fedora/tomcat/webapps/solr.war" debug="0" crossContext="true">
  <Environment name="solr/home" type="java.lang.String" value="/usr/local/fedora/solr" override="true"/>
</Context>

1311. Restart Fedora.

$ /usr/local/fedora/tomcat/bin/shutdown.sh

$ /usr/local/fedora/tomcat/bin/startup.sh

1412. Test your installation by going to http://localhost:8080/fedoragsearch/rest

1. Login using fgsAdminfedoraAdmin 
2. Click on updateindex
3. Click on updateIndex fromFoxmlFiles

15. GSearch and Solr will need to be further configured to index specific datastreams. Sample GSearch and Solr configurations can be found here and here.

Installing & Configuring the Solr Search Module

...

1. Verify that fedoraGSearch and Solr are both installed and running.
2. Download the islandora_solr_search Islandora Solr Search module and install as a Drupal module.Then, download and uncompress the Apache Solr php client and copy the Solr directory under Apache from the archive to the islandora_solr_search module's folder.
3. Log in to your Drupal site to enable the islandora_solr_search module.
   
   1. Administer > Modules and enable Islandora Solr Search