...
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).
...
Code Block |
---|
|
$ unzip fedoragsearch-2.6.zip
$ cd fedoragsearch-2.6.zip
$ cp -v fedoragsearch.war /usr/local/fedora/tomcat/webapps |
...
5. 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> |
6. Restart Fedora to deploy GSearch and Solr
Code Block |
---|
|
$ /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.
Code Block |
---|
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 |
Note |
---|
Gsearch properties files are sensitive. A space after the text at the end of a line may cause that entry to fail. |
87. Edit $FEDORA_HOME/tomcat/webapps/fedoragsearch/FgsConfig/fgsconfig-basic.xml (replace 'fgsconfig-basic.properties' with 'fgsconfig-basic-for-islandora.properties'):
Code Block |
---|
|
-- <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
Code Block |
---|
|
$ 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
Code Block |
---|
|
$ 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
Code Block |
---|
|
$ 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
Code Block |
---|
|
<?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.
Code Block |
---|
|
$ /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
- Login using fgsAdminfedoraAdmin
- Click on updateindex
- 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
...
- Verify that fedoraGSearch and Solr are both installed and running.
- 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.
- Log in to your Drupal site to enable the islandora_solr_search module.
- Administer > Modules and enable Islandora Solr Search