2013-08-28 19:24:34 -04:00
|
|
|
[[setup]]
|
2016-04-03 10:09:24 -04:00
|
|
|
= Setup Elasticsearch
|
2013-08-28 19:24:34 -04:00
|
|
|
|
|
|
|
|
[partintro]
|
|
|
|
|
--
|
2016-04-03 10:09:24 -04:00
|
|
|
This section includes information on how to setup Elasticsearch and get it
|
|
|
|
|
running, including:
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
* Downloading
|
|
|
|
|
* Installing
|
|
|
|
|
* Starting
|
|
|
|
|
* Configuring
|
2014-02-06 11:01:58 -05:00
|
|
|
|
2015-10-09 06:27:05 -04:00
|
|
|
[[supported-platforms]]
|
|
|
|
|
[float]
|
|
|
|
|
== Supported platforms
|
|
|
|
|
|
|
|
|
|
The matrix of officially supported operating systems and JVMs is available here:
|
|
|
|
|
link:/support/matrix[Support Matrix]. Elasticsearch is tested on the listed
|
|
|
|
|
platforms, but it is possible that it will work on other platforms too.
|
|
|
|
|
|
2014-09-11 05:13:19 -04:00
|
|
|
[float]
|
|
|
|
|
[[jvm-version]]
|
2016-04-03 10:09:24 -04:00
|
|
|
== Java (JVM) Version
|
2014-09-11 05:13:19 -04:00
|
|
|
|
|
|
|
|
Elasticsearch is built using Java, and requires at least
|
2015-09-22 08:23:30 -04:00
|
|
|
http://www.oracle.com/technetwork/java/javase/downloads/index.html[Java 8] in
|
2014-09-11 05:15:42 -04:00
|
|
|
order to run. Only Oracle's Java and the OpenJDK are supported. The same JVM
|
2014-12-30 11:40:19 -05:00
|
|
|
version should be used on all Elasticsearch nodes and clients.
|
2014-09-11 05:13:19 -04:00
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
We recommend installing Java version *{jdk} or later*. Elasticsearch will
|
|
|
|
|
refuse to start if a known-bad version of Java is used.
|
2014-09-11 05:13:19 -04:00
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
The version of Java that Elasticsearch will use can be configured by setting
|
|
|
|
|
the `JAVA_HOME` environment variable.
|
2014-09-11 05:13:19 -04:00
|
|
|
|
2016-12-01 17:26:29 -05:00
|
|
|
NOTE: Elasticsearch ships with default configuration for running Elasticsearch on 64-bit server JVMs. If you are using a 32-bit client JVM,
|
|
|
|
|
you must remove `-server` from <<jvm-options,jvm.options>> and if you are using any 32-bit JVM you should reconfigure the thread stack size
|
|
|
|
|
from `-Xss1m` to `-Xss320k`.
|
|
|
|
|
|
2013-08-28 19:24:34 -04:00
|
|
|
--
|
|
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
include::setup/install.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
include::setup/configuration.asciidoc[]
|
2013-09-23 11:24:31 -04:00
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
include::setup/important-settings.asciidoc[]
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2017-01-30 17:56:45 -05:00
|
|
|
include::setup/secure-settings.asciidoc[]
|
|
|
|
|
|
2016-05-27 06:03:35 -04:00
|
|
|
include::setup/bootstrap-checks.asciidoc[]
|
|
|
|
|
|
2016-04-03 10:09:24 -04:00
|
|
|
include::setup/sysconfig.asciidoc[]
|
2014-04-01 12:28:08 -04:00
|
|
|
|
|
|
|
|
include::setup/upgrade.asciidoc[]
|
2016-07-07 14:44:03 -04:00
|
|
|
|
|
|
|
|
include::setup/stopping.asciidoc[]
|
