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 testing this feature. The document assumes a POSIX operating system with cURL, a text editor, Java, and a download of Apache Solr 4.10.3. |
You should see a JSON document such as:
[{ "created":["2016-06-01T18:04:41.859Z"], "has_parent":["http://localhost:8080/fcrepo/rest/"], "id":["http://localhost:8080/fcrepo/rest/collection"], "title":[], "last_modified":["2016-06-01T18:04:41.859Z"] }] |
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.2/apache-karaf-4.0.2.tar.gz tar xvzf apache-karaf-4.0.2.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.5.1/xml/features 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.1 | | Started | fcrepo-camel-4.4.1 fcrepo-indexing-solr | 4.5.1 | x | Started | toolbox-features-4.5.1 |
The 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:
If any of the above are true, edit the configuration file ($KARAF_HOME/etc/org.fcrepo.camel.indexing.solr.cfg), updating the following elements as necessary:
# If the fedora repository requires authentication, the following values can be set: fcrepo.authUsername= fcrepo.authPassword= ... # The baseUrl for the fedora repository. fcrepo.baseUrl=localhost:8080/fcrepo/rest ... # The baseUrl for the Solr server. If using Solr 4.x or better, the URL should include # the core name. solr.baseUrl=localhost:8983/solr/collection1 |
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