/usr/share/doc/solr-common/README.Debian is in solr-common 3.6.2+dfsg-11.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | 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 libmysql-java and
add the following to your solrconfig.xml:
<lib path="/usr/share/java/mysql.jar" />
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
|