Deploying Solr

xEAC 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.0.0. Important: Solr 5.0.0 has not yet been tested with xEAC, but Solr 4.10.x has. Within $TOMCAT_HOME/webapps/orbeon/WEB-INF/resources/apps/xeac, you will find a solr-home folder. Inside solr-home there is a folder, 1.5, which refers to the Solr schema version. The Solr conf and data folders were once stored directly in 1.5, but now they have been moved into 'main' to anticipate the potential of deploying a second Solr core to facilitate spatial SPARQL queries in xEAC. $XEAC_HOME/solr-home/1.5/main 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 xEAC, 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/xeac/solr-home/1.5/main/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):

   <Context docBase="/var/lib/tomcat7/webapps/solr.war" debug="0" crossContext="true" > <Environment name="solr/home" type="java.lang.String" value="/usr/local/projects/xeac/solr-home" override="true" /> </Context>

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

<core name="xeac-published" instanceDir="1.5/main"/>

Change the instanceDir as necessary.