README for solr --------------- Solr is an enterprise search server based on the Lucene Java library. The Debian packaging of Solr consists of three binary packages: - libsolr-java contains the Java Jar files that support all other solr components. - solr-common contains the Solr software itself and general configuration. - solr-tomcat installs Solr as a servlet in Tomcat. After installation, point your browser to http://localhost:8080/solr/admin to see the Solr web administration interface. - solr-jetty installs Solr as a servlet in the Jetty application server. The Solr admin interface is at http://localhost:8080/solr/admin/ Homepage: http://lucene.apache.org/solr/ Configuration ------------- The solr-common package comes with an example configuration that is not at all suitable for production use! Please learn about solr and write your own configuration in /etc/solr. Certain features of the admin interface are disabled by tomcat security policies if this feature is enabled (disabled by default). Have a look at /etc/solr/tomcat.policy if you want to enable them. MultiCore --------- Solr upstream does not really support the separation of the application and configuration directory, but knows only a Solr "homedir". We could partly handle this by placing a symlink conf to /etc/solr/conf in /usr/share/solr. However the solr.xml file necessary to configure multicore must be placed directly into /usr/share/solr. So to avoid having a configuration file outside /etc it's recommended to place a symlink from /usr/share/solr/solr.xml to /etc/solr/solr.xml. If you want to use the dataDir parameter in the dynamic core admin interface make sure, that no datadir is specified in /etc/solr/conf/solrconfig.xml. Otherwise the latter one will always be taken. Replication ----------- Solr's replication scripts are installed into /usr/share/solr/scripts Please note that there is a java based replication solution since Solr 1.4 and that we still need to find out, whether upstream will continue to support the scripts based solution. Also have a look at Debian Bug 538229. Contrib ------- Upstream provides additional functionality in so called contributions. We have so far included only the dataimporthandler without dataimporthandler-extras. The other contributions have dependencies not yet packaged for Debian. DataImportHandler ----------------- If you use the handler with mysql, you need to install libmariadb-java and add the following to your solrconfig.xml: The handler writes status information to:: /etc/solr/conf/dataimport.properties Make sure that the tomcat/jetty user can write to this file. Yes this is ugly, but nobody has taught the FHS to java developers yet. Read more about the DataImportHandler here:: http://wiki.apache.org/solr/DataImportHandler