From 4f79234a35005dcaddc45ba6003a8c6d40658f32 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Tue, 21 Sep 2021 18:02:54 -0400 Subject: [PATCH] [DOCS] Use dedicated hosts for ES (#77582) (#78147) In production, we recommend you run {es} on a dedicated host or as a primary service. This adds that best practice to our setup documentation. Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com> Co-authored-by: Stef Nestor --- docs/reference/how-to/general.asciidoc | 1 - docs/reference/setup.asciidoc | 12 +++++++++--- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/reference/how-to/general.asciidoc b/docs/reference/how-to/general.asciidoc index d086d66adcec5..dc62a2b7b130f 100644 --- a/docs/reference/how-to/general.asciidoc +++ b/docs/reference/how-to/general.asciidoc @@ -39,4 +39,3 @@ avoid the issues with large documents, it also makes the search experience better. For instance if a user searches for two words `foo` and `bar`, a match across different chapters is probably very poor, while a match within the same paragraph is likely good. - diff --git a/docs/reference/setup.asciidoc b/docs/reference/setup.asciidoc index a08284c42f50d..ef8d51cda7f09 100644 --- a/docs/reference/setup.asciidoc +++ b/docs/reference/setup.asciidoc @@ -1,8 +1,6 @@ [[setup]] = Set up {es} -[partintro] --- This section includes information on how to setup Elasticsearch and get it running, including: @@ -35,7 +33,15 @@ https://www.oracle.com/technetwork/java/eol-135779.html[LTS version of Java]. Elasticsearch will refuse to start if a known-bad version of Java is used. The bundled JVM directory may be removed when using your own JVM. --- +[discrete] +[[dedicated-host]] +== Use dedicated hosts + +In production, we recommend you run {es} on a dedicated host or as a primary +service. Several {es} features, such as automatic JVM heap sizing, assume it's +the only resource-intensive application on the host or container. For example, +you might run {metricbeat} alongside {es} for cluster statistics, but a +resource-heavy {ls} deployment should be on its own host. include::setup/install.asciidoc[]