elasticsearch/docs/reference
David Turner e2cda1a279
"Adding nodes" instructions only work on localhost (#52677)
The introductory sections of the reference manual contains some simplified
instructions for adding a node to the cluster. Unfortunately they are a little
too simplified and only really work for clusters running on `localhost`. If you
try and follow these instructions for a distributed cluster then the new node
will, confusingly, auto-bootstrap itself into a distinct one-node cluster.

Multiple nodes running on localhost is a valid config, of course, but we should
spell out that these instructions are really only for experimentation and that
it takes a bit more work to add nodes to a distributed cluster. This commit
does so.

Also, the "important config" instructions for discovery say that you MUST set
`discovery.seed_hosts` whereas in fact it is fine to ignore this setting and
use a dynamic discovery mechanism instead. This commit weakens this statement
and links to the docs for dynamic discovery mechanisms.

Finally, this section is also overloaded with some technical details that are
not important for this context and are adequately covered elsewhere, and
completely fails to note that the default discovery port is 9300. This commit
addresses this.
2020-02-27 08:51:17 +00:00
..
aggregations [DOCS] Links transforms in aggregation docs (#52563) 2020-02-21 08:22:04 +01:00
analysis [DOCS] Fixed typo in jump link. (#52302) 2020-02-12 17:52:11 -08:00
autoscaling Add autoscaling API skelton (#51564) 2020-02-06 19:15:17 -05:00
cat [DOCS] Adds cat datafeeds API (#52738) 2020-02-26 09:20:36 -08:00
ccr Remove outdated requirement of CCR (#50859) 2020-01-13 19:59:50 -05:00
cluster [Docs] Clarify default value for allow_no_indices (#52635) 2020-02-24 11:37:29 +01:00
commands [Docs] Fix typo in node-tool.asciidoc (#51667) 2020-01-31 10:38:27 +01:00
docs [DOCS] Update term vectors snippet to prevent CI failure (#52819) 2020-02-26 12:35:05 -05:00
eql [DOCS] Add EQL limitations page (#52001) 2020-02-12 08:45:15 -05:00
graph [DOCS] [2 of 5] Change // CONSOLE comments to [source,console] (#46353) 2019-09-09 13:13:41 -04:00
high-availability [DOCS] Move snapshot-restore out of modules. (#49618) 2020-01-09 16:12:02 -08:00
how-to Clarify the resiliency trade-off of disabling replicas to speed up indexing. (#52714) 2020-02-25 08:52:33 +01:00
ilm [DOCS] Correct policy name in ILM docs example (#52354) 2020-02-25 09:35:26 -05:00
images SQL: update ODBC docs, cover Cloud ID, latest params (#52291) 2020-02-19 17:33:48 +01:00
index-modules Discourage from opting in for the niofs store. (#52638) 2020-02-25 08:52:53 +01:00
indices [Docs] Clarify default value for allow_no_indices (#52635) 2020-02-24 11:37:29 +01:00
ingest [DOS] Fix typo in CSV processor docs (#52649) 2020-02-25 08:47:58 -05:00
licensing [DOCS] Augments update license API (#51903) 2020-02-05 11:07:02 -08:00
mapping [DOCS] Document include_in_* nested mapping parms (#52648) 2020-02-25 07:12:34 -05:00
migration Percentiles aggregation: disallow specifying same percentile v… (#52257) 2020-02-26 13:40:33 +01:00
ml [DOCS] Adds cat datafeeds API (#52738) 2020-02-26 09:20:36 -08:00
modules "Adding nodes" instructions only work on localhost (#52677) 2020-02-27 08:51:17 +00:00
monitoring [DOCS] Fixes monitoring links (#52790) 2020-02-25 16:57:38 -08:00
query-dsl Correct boost calculation in script_score query (#52478) 2020-02-24 10:46:33 -05:00
release-notes Percentiles aggregation: disallow specifying same percentile v… (#52257) 2020-02-26 13:40:33 +01:00
rest-api Correct the name of the search timeout parameter. (#52733) 2020-02-24 14:57:49 -08:00
rollup [DOCS] Merge rollup config details into API (#49412) 2019-11-22 08:31:30 -08:00
scripting Scripting: Add char position of script errors (#51069) 2020-01-21 10:57:09 -07:00
search [DOCS] Correct multi search API docs (#52523) 2020-02-24 07:41:53 -05:00
settings Update ilm-settings.asciidoc (#51577) 2020-02-25 10:17:07 -05:00
setup "Adding nodes" instructions only work on localhost (#52677) 2020-02-27 08:51:17 +00:00
slm Correct SLM retention timezone documentation (#52533) 2020-02-19 13:45:32 -07:00
snapshot-restore [DOCS] Align with ILM API docs (#48705) 2020-01-22 20:44:19 -08:00
sql remove references to the SQL API from ODBC config (#52765) 2020-02-26 13:32:22 +01:00
testing Uppercasing some docs section title (#37781) 2019-01-24 22:54:55 +01:00
transform [DOCS] Correct important note for xpack.transform.enabled (#52194) 2020-02-11 12:54:09 +00:00
upgrade Goodbye and thank you synced flush! (#50882) 2020-01-16 09:43:07 -05:00
vectors Remove the 'experimental' marking from vector fields. (#49120) 2019-11-18 11:57:18 -08:00
aggregations.asciidoc [Docs] Update aggregations.asciidoc (#29265) 2018-03-28 15:01:45 +02:00
analysis.asciidoc [DOCS] Add attribute for Lucene analysis links (#51687) 2020-01-30 11:22:30 -05:00
api-conventions.asciidoc Remove type field from DocWriteRequest and associated Response objects (#47671) 2019-10-11 10:23:55 +01:00
cat.asciidoc [DOCS] Adds cat datafeeds API (#52738) 2020-02-26 09:20:36 -08:00
cluster.asciidoc Password-protected Keystore Feature Branch PR (#51123) 2020-01-27 19:51:39 -05:00
data-rollup-transform.asciidoc [DOCS] Adds transforms to Elasticsearch book (#46846) 2019-09-24 15:56:18 -07:00
docs.asciidoc [DOCS] Remove heading offsets for REST APIs (#44568) 2019-07-19 14:35:36 -04:00
frozen-indices.asciidoc [DOCS] [2 of 5] Change // CONSOLE comments to [source,console] (#46353) 2019-09-09 13:13:41 -04:00
getting-started.asciidoc [DOCS] Switch to standard ESS trial links (#52552) 2020-02-21 12:04:39 -05:00
glossary.asciidoc [DOCS] Split off ILM overview to a separate topic. (#51287) 2020-01-27 19:39:24 -08:00
gs-index.asciidoc [DOCS] Adding index file for GS "mini book". 2017-07-18 13:44:08 -07:00
high-availability.asciidoc [DOCS] Remove leveloffset for CCR docs (#46818) 2019-09-18 09:44:28 -04:00
how-to.asciidoc Correct grammar in list in how-to docs 2017-01-17 20:57:22 -05:00
index-extra-title-page.html [DOCS] Add index-extra-title-page.html for direct HTML migration (#50189) 2019-12-13 12:44:12 -05:00
index-modules.asciidoc Deprecate creation of dot-prefixed index names except for hidden and system indices (#49959) 2020-01-27 17:18:26 -07:00
index.asciidoc [DOCS] Include docs on permanently unreleased branches only (#51743) 2020-02-11 11:22:49 -05:00
index.x.asciidoc [DOCS] Removes redundant index.asciidoc files (#30707) 2018-05-18 11:05:40 -07:00
indices.asciidoc Goodbye and thank you synced flush! (#50882) 2020-01-16 09:43:07 -05:00
ingest.asciidoc Replace required pipeline with final pipeline (#49470) 2019-11-22 14:00:38 -05:00
intro.asciidoc [DOCS] Updates ML links (#50387) 2019-12-19 14:47:28 -08:00
mapping.asciidoc [DOCS] Note clause limit in index.mapping.total_fields.limit docs (#48153) 2019-10-18 10:20:23 -04:00
modules.asciidoc [DOCS] Align with ILM API docs (#48705) 2020-01-22 20:44:19 -08:00
query-dsl.asciidoc Add a cluster setting to disallow expensive queries (#51385) 2020-02-12 18:06:04 +01:00
redirects.asciidoc [DOCS] Fixes monitoring links (#52790) 2020-02-25 16:57:38 -08:00
release-notes.asciidoc [DOCS] Adds placeholders for v8 highlights, breaking changes, release notes (#38641) 2019-02-08 15:48:42 -08:00
scripting.asciidoc [DOCS] Move 'Scripting' section to top-level navigation. (#42939) 2019-06-06 10:45:04 -04:00
search.asciidoc Use snake casing for document field (#45432) 2019-09-19 14:26:31 +02:00
setup.asciidoc [DOCS] Creates a cluster restart documentation page (#48583) 2019-11-12 14:49:11 +01:00
testing.asciidoc [Docs] Unify spelling of Elasticsearch (#27567) 2017-11-29 09:44:25 +01:00
upgrade.asciidoc Clarify that you cannot abort an upgrade (#47342) 2019-10-02 09:27:17 +01:00