2013-08-28 19:24:34 -04:00
|
|
|
[[setup]]
|
|
|
|
|
= Setup
|
|
|
|
|
|
|
|
|
|
[partintro]
|
|
|
|
|
--
|
|
|
|
|
This section includes information on how to setup *elasticsearch* and
|
|
|
|
|
get it running. If you haven't already, http://www.elasticsearch.org/download[download] it, and
|
|
|
|
|
then check the <<setup-installation,installation>> docs.
|
|
|
|
|
|
|
|
|
|
[[setup-installation]]
|
|
|
|
|
[float]
|
|
|
|
|
== Installation
|
|
|
|
|
|
|
|
|
|
After link:/download[downloading] the latest release and extracting it,
|
|
|
|
|
*elasticsearch* can be started using:
|
|
|
|
|
|
|
|
|
|
[source,sh]
|
|
|
|
|
--------------------------------------------------
|
|
|
|
|
$ bin/elasticsearch
|
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
2013-12-15 14:29:11 -05:00
|
|
|
Under *nix system, the command will start the process in the foreground.
|
|
|
|
|
To run it in the background, add the `-d` switch to it:
|
2013-08-28 19:24:34 -04:00
|
|
|
|
|
|
|
|
[source,sh]
|
|
|
|
|
--------------------------------------------------
|
2013-12-15 14:29:11 -05:00
|
|
|
$ bin/elasticsearch -d
|
2013-08-28 19:24:34 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
|
|
2014-01-06 15:58:46 -05:00
|
|
|
Elasticsearch is built using Java, and requires at least
|
2013-08-28 19:24:34 -04:00
|
|
|
http://java.sun.com/javase/downloads/index.jsp[Java 6] in order to run.
|
|
|
|
|
The version of Java that will be used can be set by setting the
|
|
|
|
|
`JAVA_HOME` environment variable.
|
|
|
|
|
|
|
|
|
|
.*NIX
|
|
|
|
|
*************************************************************************
|
|
|
|
|
There are added features when using the `elasticsearch` shell script.
|
|
|
|
|
The first, which was explained earlier, is the ability to easily run the
|
|
|
|
|
process either in the foreground or the background.
|
|
|
|
|
|
2013-12-16 05:30:10 -05:00
|
|
|
Another feature is the ability to pass `-X` and `-D` or getopt long style
|
|
|
|
|
configuration parameters directly to the script. When set, all override
|
|
|
|
|
anything set using either `JAVA_OPTS` or `ES_JAVA_OPTS`. For example:
|
2013-08-28 19:24:34 -04:00
|
|
|
|
|
|
|
|
[source,sh]
|
|
|
|
|
--------------------------------------------------
|
2014-01-17 05:44:30 -05:00
|
|
|
$ bin/elasticsearch -Xmx2g -Xms2g -Des.index.store.type=memory --node.name=my-node
|
2013-08-28 19:24:34 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
|
*************************************************************************
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
include::setup/configuration.asciidoc[]
|
|
|
|
|
|
|
|
|
|
include::setup/as-a-service.asciidoc[]
|
|
|
|
|
|
2013-09-23 11:24:31 -04:00
|
|
|
include::setup/as-a-service-win.asciidoc[]
|
|
|
|
|
|
2013-08-28 19:24:34 -04:00
|
|
|
include::setup/dir-layout.asciidoc[]
|
|
|
|
|
|
2013-12-19 09:54:40 -05:00
|
|
|
include::setup/repositories.asciidoc[]
|
