Apache
/
lucene
mirror of https://github.com/apache/lucene.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Apache Lucene open-source search software
32,942 Commits 29 Branches 469 Tags 740 MiB
Java 97.7%
HTML 1%
Python 0.9%
Lex 0.3%
Go to file
Dawid Weiss 8b03a7104e Add a precommit placeholder task and working copy's git status check. 2020-01-03 15:22:36 +01:00
.github LUCENE-8944: remove "I am authorized to contribute" wording in the Pull Request Template 2019-12-10 12:34:23 +00:00
buildSrc Move intiial environment checks to buildSrc so that they happen before any other script has a chance to evaluate. 2020-01-03 14:46:29 +01:00
dev-tools Minor fixes to the release wizard. (#1127) 2019-12-30 17:21:18 +01:00
gradle Add a precommit placeholder task and working copy's git status check. 2020-01-03 15:22:36 +01:00
help Changed license checksum regeneration task name to updateLicenses. 2019-12-18 14:14:39 +01:00
lucene Merge remote-tracking branch 'origin/master' into gradle-master 2020-01-03 14:13:21 +01:00
solr Follow-up unused import removal. 2020-01-03 14:20:21 +01:00
.asf.yaml LUCENE-8986: labels: remove dubious 'sql', add 'information-retrieval' 2019-10-28 10:19:13 -04:00
.gitattributes Initial gradle build layer. 2019-12-02 15:34:57 +01:00
.gitignore Generate hardware-specific defaults for gradle parallelism on the first build run (any task). Add some explanations on how to tweak local settings even further (gradlew :helpLocalSettings 2019-12-05 11:14:09 +01:00
.hgignore LUCENE-2792: add FST impl 2010-12-12 15:36:08 +00:00
.travis.yml Initial gradle build layer. 2019-12-02 15:34:57 +01:00
README.md Remove extra period 2019-09-15 05:12:12 +09:00
build.gradle Add a precommit placeholder task and working copy's git status check. 2020-01-03 15:22:36 +01:00
build.xml Update JGit for working copy checks and explicitely set nop-logging 2019-04-20 01:55:23 +02:00
gradlew Upgrade gradlew. Add environment sanity check. 2019-12-16 15:23:06 +01:00
gradlew.bat Upgrade gradlew. Add environment sanity check. 2019-12-16 15:23:06 +01:00
settings.gradle Initial gradle build layer. 2019-12-02 15:34:57 +01:00
versions.lock Upgrade rr to 2.7.6 2019-12-31 10:10:51 +01:00
versions.props Upgrade rr to 2.7.6 2019-12-31 10:10:51 +01: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.

Build Status Build Status

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

If you see an error about Ivy missing while invoking Ant (e.g., .ant/lib does not exist), run ant ivy-bootstrap and retry.

Sometimes you may face issues with Ivy (e.g., an incompletely downloaded artifact). Cleaning up the Ivy cache and retrying is a workaround for most of such issues:

rm -rf ~/.ivy2/cache

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 (See this for details)
  • IntelliJ - ant idea (See this for details)
  • Netbeans - ant netbeans (See this for details)

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