Google Git
Sign in
apache / lucene / 5caadc12f4b00b882ec6235d317c82d823d21ff7
commit5caadc12f4b00b882ec6235d317c82d823d21ff7[log] [tgz]
authorChris Hostetter <hossman@apache.org>Wed Dec 02 10:24:36 2020 -0700
committerChris Hostetter <hossman@apache.org>Wed Dec 02 13:37:33 2020 -0700
treeea29e3ac72515e5c67a91500467092f1f4249aa0
parent6af56e141a52f4e616985ca5b03dda3677889bfa [diff]
SOLR-14934: Refactored duplicate "Solr Home" logic into a single place to eliminate risk of tests using divergent values for a single solr node.

(cherry picked from commit 2e6a02394ec4eea6ba72d5bc2bf02c0139a54f39)
(cherry picked from commit 05a8477a362beb6b0e5a02b6ee4dfa106a2e6a76)
26 files changed
tree: ea29e3ac72515e5c67a91500467092f1f4249aa0
  1. dev-docs/
  2. dev-tools/
  3. lucene/
  4. solr/
  5. .gitignore
  6. .hgignore
  7. build.xml
  8. README.md
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

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