This guide will help you get up and running with a Fedora 4 instance whose updates are automatically indexed in a Solr repository. This guide glosses over many details and should be considered a starting point for using this feature. The document assumes a POSIX operating system with cURL, a text editor, Java, and a download of Apache Solr 4.10.3. |
wget http://archive.apache.org/dist/lucene/solr/4.10.3/solr-4.10.3.tgz tar -xzvf solr-4.10.3.tgz |
The location of your untarred Solr installation will be hereinafter referenced as $SOLR_HOME.
wget https://raw.githubusercontent.com/fcrepo4-exts/fcrepo4-vagrant-base-box/master/config/schema.xml cp schema.xml $SOLR_HOME/example/solr/collection1/conf/ |
cd $SOLR_HOME/example java -jar start.jar |
wget http://archive.apache.org/dist/karaf/4.0.5/apache-karaf-4.0.5.tar.gz tar xvzf apache-karaf-4.0.5.tar.gz |
The location of your untarred Karaf installation will be hereinafter referenced as $KARAF_HOME.
cd $KARAF_HOME ./bin/karaf |
After running the command above
you should be put into the Karaf client shell, such as:
__ __ ____
/ //_/____ __________ _/ __/
/ ,< / __ `/ ___/ __ `/ /_
/ /| |/ /_/ / / / /_/ / __/
/_/ |_|\__,_/_/ \__,_/_/
Apache Karaf (4.0.2)
karaf@root()> |
Note, to exit the Karaf client shell, type: CTRL-D. This will stop the Karaf server, ending the indexing process.
To run Karaf as a system service please refer to the Karaf Service Wrapper documentation.
In the Karaf client shell type the following:
feature:repo-add mvn:org.fcrepo.camel/toolbox-features/4.6.2/xml/features feature:install fcrepo-service-activemq feature:install fcrepo-indexing-solr |
Still in the Karaf client shell, the following command
feature:list|grep fcrepo |
should result in both the fcrepo-camel and fcrepo-indexing-solr features being in the Started state
fcrepo-camel | 4.4.3 | | Started | fcrepo-camel-4.4.3 fcrepo-indexing-solr | 4.6.2 | x | Started | toolbox-features-4.6.2 fcrepo-ldpath | 4.6.2 | | Started | toolbox-features-4.6.2 fcrepo-service-ldcache-file | 4.6.2 | | Started | toolbox-features-4.6.2 fcrepo-marmotta-osgi | 4.6.2 | | Started | toolbox-features-4.6.2 |
You should see a JSON document such as:
[{"extent":[],"references":[],"prev":[],"altLabel":[],"type":["http://fedora.info/definitions/v4/repository#Container","http://fedora.info/definitions/v4/repository#Resource","http://www.w3.org/ns/ldp#Container","http://www.w3.org/ns/ldp#RDFSource"],"narrowMatch":[],"relation":[],"accrualMethod":[],"notation":[],"id":["http://localhost:8080/fcrepo/rest/collection"],
...
"lastModifiedBy":["bypassAdmin"],"prefLabel":[],"alternative":[],"label":[],"accessTo":[],"createdBy":["bypassAdmin"],"hiddenLabel":[],"comment":[],"accessRights":[],"sameAs":[]
}] |
The main configuration of the fcrepo-indexing-solr feature is found at: $KARAF_HOME/etc/org.fcrepo.camel.indexing.solr.cfg
You will need to make updates to this configuration file if any of the following are true:
For configuration details, please refer to the documentation found at the fcrepo-indexing-solr github page. If you updated the $KARAF_HOME/etc/org.fcrepo.camel.indexing.solr.cfg file, it is quite likely that you will also need to update the $KARAF_HOME/etc/org.fcrepo.camel.ldpath.cfg file, particularly the sections related to Fedora location and authorization. Please refer to the fcrepo-ldpath page on github for configuration details.
You should now be able to create/update/delete resources in your Fedora repository, and subsequently see them in your Solr index!
For debugging purposes, you may want to inspect the logs of the various applications:
/var/log/tomcat8/catalina.out$SOLR_HOME/example/logs/solr.log$KARAF_HOME/data/log/karaf.log