lucene/solr/example
Noble Paul 6386f1760f SOLR-6471
git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1622773 13f79535-47bb-0310-9956-ffa450edef68
2014-09-05 19:44:45 +00:00
..
contexts SOLR-4353: Renamed example jetty context file to reduce confusion 2013-01-25 00:59:04 +00:00
etc SOLR-4984: etc/logging.properties in example should be removed 2013-09-15 03:19:16 +00:00
example-DIH SOLR-6378: Fixed example/example-DIH/ issues with "tika" and "solr" configurations, and tidied up README.txt 2014-08-19 14:56:26 +00:00
example-schemaless/solr SOLR-6471 2014-09-05 19:44:45 +00:00
exampledocs SOLR-6378: Fixed example/example-DIH/ issues with "tika" and "solr" configurations, and tidied up README.txt 2014-08-19 14:56:26 +00:00
multicore LUCENE-5850: Made Version handling more robust and extensible 2014-08-15 19:15:17 +00:00
resources SOLR-4977: Add option to send infostream to the logging system 2013-07-02 13:34:12 +00:00
scripts SOLR-6120: Print a helpful error message from zkcli.bat when war is not extracted. 2014-07-14 17:31:14 +00:00
solr SOLR-6365 refactoring and cleanup 2014-09-04 00:16:31 +00:00
solr-webapp removed by mistake - put it back 2012-12-06 00:24:00 +00:00
README.txt SOLR-3706: Ship setup to log with log4j. 2013-03-27 14:09:38 +00:00
build.xml SOLR-3706: remove log dependencies from core, exclude example log jars from test classpath, add versions to example log jars 2013-03-28 15:14:29 +00:00
ivy.xml LUCENE-5249: All Lucene/Solr modules should use the same dependency versions 2013-10-01 21:01:12 +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 example
------------

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

To run this example:

  java -jar start.jar

in this example directory, and when Solr is started connect to 

  http://localhost:8983/solr/

To add documents to the index, use the post.jar (or post.sh script) in
the example/exampledocs subdirectory (while Solr is running), for example:

     cd exampledocs
     java -jar post.jar *.xml
Or:  sh post.sh *.xml

For more information about this example please read...

 * example/solr/README.txt
   For more information about the "Solr Home" and Solr specific configuration
 * http://lucene.apache.org/solr/tutorial.html
   For a Tutorial using this example configuration
 * http://wiki.apache.org/solr/SolrResources 
   For a list of other tutorials and introductory articles.

Notes About These Examples
--------------------------

* SolrHome *

By default, start.jar starts Solr in Jetty using the default Solr Home
directory of "./solr/" (relative to the working directory of hte servlet 
container).  To run other example configurations, you can specify the 
solr.solr.home system property when starting jetty...

  java -Dsolr.solr.home=multicore -jar start.jar
  java -Dsolr.solr.home=example-DIH/solr -jar start.jar

* 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.