lucene/solr/server/README.md

3.8 KiB

Solr server

This directory contains an instance of the Jetty Servlet container setup to run Solr.

To run Solr:

  cd $SOLR_INSTALL
  bin/solr start

where $SOLR_INSTALL is the location where you extracted the Solr installation bundle.

Server directory layout

server/contexts

  This directory contains the Jetty Web application deployment descriptor for the Solr Web app.

server/etc

  Jetty configuration and example SSL keystore

server/lib

  Jetty and other 3rd party libraries

server/logs

  Solr log files

server/resources

  Contains configuration files, such as the Log4j configuration (log4j2.xml) for configuring Solr loggers.

server/scripts/cloud-scripts

  Command-line utility for working with ZooKeeper when running in SolrCloud mode, see zkcli.sh / .cmd for
  usage information.

server/solr

  Default solr.solr.home directory where Solr will create core directories; must contain solr.xml

server/solr/configsets

  Directories containing different configuration options for running Solr.

    _default                    : Bare minimum configurations with field-guessing and managed schema turned
                                  on by default, so as to start indexing data in Solr without having to design
                                  a schema upfront. You can use the REST API to manage your schema as you refine your index
                                  requirements. You can turn off the field (for a collection, say mycollection) guessing by:
                                  curl http://host:8983/solr/mycollection/config -d '{"set-user-property": {"update.autoCreateFields":"false"}}'

    sample_techproducts_configs : Comprehensive example configuration that demonstrates many of the powerful
                                  features of Solr, based on the use case of building a search solution for
                                  tech products.

server/solr-webapp

  Contains files used by the Solr server; do not edit files in this directory (Solr is not a Java Web application).

Notes About Solr Examples

SolrHome

By default, start.jar starts Solr in Jetty using the default Solr Home directory of "./solr/" (relative to the working directory of the servlet container).

References to Jar Files Outside This Directory

Various example SolrHome dirs contained in this directory may use "" statements in the solrconfig.xml file to reference plugin jars outside of this directory for loading "contrib" plugins via relative paths.

If you make a copy of this example server and wish to use the ExtractingRequestHandler (SolrCell), the clustering component, or any other modules in "contrib", you will need to copy the required jars or update the paths to those jars in your solrconfig.xml.

Logging

By default, Jetty & Solr will log to the console and logs/solr.log. This can be convenient when first getting started, but eventually you will want to log just to a file. To configure logging, edit the log4j2.xml file in "resources".

It is also possible to setup log4j or other popular logging frameworks.