2019-12-20 00:53:09 +08:00
|
|
|
= Elasticsearch
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
Elasticsearch is the distributed, RESTful search and analytics engine at the
|
|
|
|
heart of the https://www.elastic.co/products[Elastic Stack]. You can use
|
|
|
|
Elasticsearch to store, search, and manage data for:
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
* Logs
|
|
|
|
* Metrics
|
|
|
|
* A search backend
|
|
|
|
* Application monitoring
|
|
|
|
* Endpoint security
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
\... and more!
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
To learn more about Elasticsearch's features and capabilities, see our
|
|
|
|
https://www.elastic.co/products/elasticsearch[product page].
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
[[get-started]]
|
|
|
|
== Get started
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
The simplest way to set up Elasticsearch is to create a managed deployment with
|
|
|
|
https://www.elastic.co/cloud/as-a-service[Elasticsearch Service on Elastic
|
|
|
|
Cloud].
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
If you prefer to install and manage Elasticsearch yourself, you can download
|
|
|
|
the latest version from
|
|
|
|
https://www.elastic.co/downloads/elasticsearch[elastic.co/downloads/elasticsearch].
|
2015-04-29 20:32:16 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
For more installation options, see the
|
|
|
|
https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html[Elasticsearch installation
|
|
|
|
documentation].
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
[[upgrade]]
|
|
|
|
== Upgrade
|
2021-03-25 21:31:28 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
To upgrade from an earlier version of Elasticsearch, see the
|
|
|
|
https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html[Elasticsearch upgrade
|
|
|
|
documentation].
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
[[build-source]]
|
|
|
|
== Build from source
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2019-12-20 00:53:09 +08:00
|
|
|
Elasticsearch uses https://gradle.org[Gradle] for its build system.
|
2011-04-21 15:43:43 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
To build a distribution for your local OS and print its output location upon
|
2020-11-03 07:00:36 +08:00
|
|
|
completion, run:
|
2020-11-02 23:13:05 +08:00
|
|
|
----
|
2021-04-20 21:32:21 +08:00
|
|
|
./gradlew localDistro
|
2020-11-02 23:13:05 +08:00
|
|
|
----
|
2011-04-21 15:43:43 +08:00
|
|
|
|
2020-11-03 07:00:36 +08:00
|
|
|
To build a distribution for another platform, run the related command:
|
2020-11-02 23:13:05 +08:00
|
|
|
----
|
|
|
|
./gradlew :distribution:archives:linux-tar:assemble
|
|
|
|
./gradlew :distribution:archives:darwin-tar:assemble
|
|
|
|
./gradlew :distribution:archives:windows-zip:assemble
|
|
|
|
----
|
2020-11-03 07:00:36 +08:00
|
|
|
|
|
|
|
To build distributions for all supported platforms, run:
|
|
|
|
----
|
|
|
|
./gradlew assemble
|
|
|
|
----
|
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
Distributions are output to `distributions/archives`.
|
|
|
|
|
|
|
|
To run the test suite, see xref:TESTING.asciidoc[TESTING].
|
|
|
|
|
|
|
|
[[docs]]
|
|
|
|
== Documentation
|
|
|
|
|
|
|
|
For the complete Elasticsearch documentation visit
|
|
|
|
https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html[elastic.co].
|
|
|
|
|
|
|
|
For information about our documentation processes, see the
|
|
|
|
xref:docs/README.asciidoc[docs README].
|
|
|
|
|
|
|
|
[[contribute]]
|
|
|
|
== Contribute
|
|
|
|
|
|
|
|
For contribution guidelines, see xref:CONTRIBUTING.md[CONTRIBUTING].
|
2010-02-08 21:30:06 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
[[questions]]
|
|
|
|
== Questions? Problems? Suggestions?
|
2013-09-14 01:50:56 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
* To report a bug or request a feature, create a
|
|
|
|
https://github.com/elastic/elasticsearch/issues/new/choose[GitHub Issue]. Please
|
|
|
|
ensure someone else hasn't created an issue for the same topic.
|
2014-04-02 00:28:08 +08:00
|
|
|
|
2021-04-20 21:32:21 +08:00
|
|
|
* Need help using Elasticsearch? Reach out on the
|
|
|
|
https://discuss.elastic.co[Elastic Forum] or https://ela.st/slack[Slack]. A
|
|
|
|
fellow community member or Elastic engineer will be happy to help you out.
|