lucene/solr/server
Erik Hatcher 0ff1e75b74 SOLR-6779 (fix /browse on schemaless example) and several other related fixes and cleanups including remove /browse from test configs where it isn't needed, adjusting /browse definition to be valid and not an inappropriate copy of techproducts, fixed /update/extract indexing with data_driven_schema_configs configset, and fixed indexing of solr(-to-solr) example DIH indexing
git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1648456 13f79535-47bb-0310-9956-ffa450edef68
2014-12-30 00:50:57 +00:00
..
contexts SOLR-3619: Rename 'example' dir to 'server' 2014-10-31 04:30:52 +00:00
etc LUCENE-6134: fix typos: it's->its, its->it's, etc. 2014-12-24 05:48:58 +00:00
resources SOLR-6833: Examples started with bin/solr -e should use a solr.solr.home directory under the example directory instead of server/solr. 2014-12-12 00:21:27 +00:00
scripts SOLR-3619: Rename 'example' dir to 'server' 2014-10-31 04:30:52 +00:00
solr SOLR-6779 (fix /browse on schemaless example) and several other related fixes and cleanups including remove /browse from test configs where it isn't needed, adjusting /browse definition to be valid and not an inappropriate copy of techproducts, fixed /update/extract indexing with data_driven_schema_configs configset, and fixed indexing of solr(-to-solr) example DIH indexing 2014-12-30 00:50:57 +00:00
solr-webapp SOLR-3619: Rename 'example' dir to 'server' 2014-10-31 04:30:52 +00:00
README.txt SOLR-3619: Rename 'example' dir to 'server' 2014-10-31 04:30:52 +00:00
build.xml LUCENE-6074: symlink jars on unix/os X systems 2014-11-23 18:00:11 +00:00
ivy.xml SOLR-3619: Rename 'example' dir to 'server' 2014-10-31 04:30:52 +00:00

README.txt

# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

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 (log4j.properties) 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.

    basic_configs               : Bare minimum configuration settings needed to run Solr.

    data_driven_schema_configs  : Field-guessing and managed schema mode; use this configuration if you want
                                  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.

    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

  Jetty will extract the solr.war into this directory at runtime.

server/webapps

  Contains the solr.war file.


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 "<lib>"
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), DataImportHandler (DIH), UIMA, 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 a 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 log4j.properties file in "resources".
 
It is also possible to setup log4j or other popular logging frameworks.