Apache Lucene open-source search software
Go to file
Cassandra Targett 7752c05252 Ref Guide: clean up typos & other minor issues; last phase of 7.0 pre-release review 2017-09-25 21:24:40 -05:00
dev-tools SOLR-11382: Maven build: Build the test-jar for lucene-spatial3d, which lucene-spatial tests now depend on 2017-09-25 20:09:27 -04:00
lucene Update dictionary version for Ukrainian analyzer to 3.9.0. 2017-09-25 13:37:26 +02:00
solr Ref Guide: clean up typos & other minor issues; last phase of 7.0 pre-release review 2017-09-25 21:24:40 -05:00
.gitignore .gitignore: /maven-build 2017-09-20 15:31:25 -04:00
.hgignore LUCENE-2792: add FST impl 2010-12-12 15:36:08 +00:00
README.md LUCENE-5822 Add markdown-compatible README.md 2017-06-30 10:57:09 -05:00
build.xml SOLR-11181: fix validate-maven-dependencies 2017-09-07 09:24:02 -04:00

README.md

Apache Lucene and Solr

Apache Lucene is a high-performance, full featured text search engine library written in Java.

Apache Solr is an enterprise search platform written using Apache Lucene. Major features include full-text search, index replication and sharding, and result faceting and highlighting.

Online Documentation

This README file only contains basic setup instructions. For more comprehensive documentation, visit:

Building Lucene/Solr

(You do not need to do this if you downloaded a pre-built package.)

Lucene and Solr are built using Apache Ant. To build Lucene and Solr, run:

ant compile

The Solr server can then be packaged and prepared for startup by running the following command from the solr/ directory:

ant server

Running Solr

After building Solr, the server can be started using the bin/solr control scripts. Solr can be run in either standalone or distributed (SolrCloud mode).

To run Solr in standalone mode, run the following command from the solr/ directory:

bin/solr start

To run Solr in SolrCloud mode, run the following command from the solr/ directory:

bin/solr start -c

The bin/solr control script allows heavy modification of the started Solr. Common options are described in some detail in solr/README.txt. For an exhaustive treatment of options, run bin/solr start -h from the solr/ directory.

Development/IDEs

Ant can be used to generate project files compatible with most common IDEs. Run the ant command corresponding to your IDE of choice before attempting to import Lucene/Solr.

  • Eclipse - ant eclipse
  • IntelliJ - ant idea
  • Netbeans - ant netbeans

Running Tests

The standard test suite can be run with the command:

ant test

Like Solr itself, the test-running can be customized or tailored in a number or ways. For an exhaustive discussion of the options available, run:

ant test-help

Contributing

Please review the Contributing to Solr Guide for information on contributing.

Discussion and Support