Deploying Solr

Numishare requires Apache Solr to power its public user interface. At the time of the publication of these instructions, the current version of Solr is 5.x. Important: Solr 5.x has not yet been tested with Numishare, but Solr 4.10.x has. Within $TOMCAT_HOME/webapps/orbeon/WEB-INF/resources/apps/numishare, you will find a solr-home folder. Inside solr-home there is a folder, 1.5, which corresponds to the Solr schema version. $NUMISHARE_HOME/solr-home/1.5 contains a conf folder. Conf includes all of the configuration files necessary for that particular version of Solr. The schema.xml file contains a list of fields necessary for text searching in Numishare, faceting browsing, mapping, and other such queries.

Important: In 1.5/main (or different schema version numbers), create a “data” folder and assign permissions which will grant the tomcat user write access. In Ubuntu running Tomcat7, you may simply change the owner to username tomcat7, group name tomcat7, e.g., sudo chmod -R tomcat7:tomcat7 /usr/local/projects/numishare/solr-home/1.5/data

##Download and Install

1. Download the latest version of Solr
2. If using Solr 5.0.0, extract server/webapps/solr.war and put into $TOMCAT_HOME/webapps. In previous versions, the war file is located at examples/webapps/solr.war.
3. Solr 4.3 and later: set up log4j logging, or else Solr will not start. See wiki. Pay attention to #3 especially. '-Dlog4j.configuration=/path/to/log4j.properties' may be inserted into JAVA_OPTS (in Ubuntu, edit /etc/default/tomcat7).

##Set Solr Home

1. Create solr.xml in $TOMCAT_HOME/conf/Catalina/localhost

2. Insert the following XML fragment (substituting directory paths when necessary):

$NUMISHARE_HOME/solr-home/solr.xml contains contains multicore information. By default it includes the following snippet of XML:

<core name="numishare-published" instanceDir="1.5"/>

Change the instanceDir as necessary, especially if you are running Solr cores for other projects on the same server.