elasticsearch/docs/reference
David Turner 2adeb4a666
Expand and consolidate networking docs (#68051)
Today's network config docs are split into "Network", "HTTP" and
"Transport" pages, with unclear relationships between them. We often
encounter users with weird configs that indicate they don't really
understand how these settings all relate. In fact these pages are all
very interrelated, and the HTTP and Transport pages are almost all only
for advanced users. This commit brings these docs into a single page and
rewords some things to try and guide users away from the advanced
settings unless their configuration needs all the extra complexity.

It also adds a section entitled "Binding and publishing" which clarifies
the meanings of the `bind_host` and `publish_host` parameters. This is
also a common source of confusion amongst users.

It also clarifies that many of these settings accept a list of
addresses, and warns that this may not be what you want. Closes #67956.

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2021-02-01 13:06:20 +00:00
..
aggregations [DOCS] Fix acasting for agg types (#67469) 2021-01-13 14:44:54 -05:00
analysis [DOCS] Clean up index template xrefs (#67264) 2021-01-11 12:38:09 -05:00
autoscaling [DOCS] Fixes typo in decider docs. (#67743) 2021-01-20 10:51:17 +01:00
cat [DOCS] Add security privileges to cat API docs (#67467) 2021-01-20 10:19:20 -05:00
ccr Protect replicated data streams against local rollovers (#64710) 2020-12-08 08:34:24 +01:00
cluster Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00:00
commands Remove support of creating CA on the fly when generating certificates (#65590) 2020-12-16 13:54:32 +11:00
data-streams Adjust manage_follow_index privilege for promote data stream api (#67773) 2021-01-21 09:08:27 +01:00
docs [DOCS] Add security privileges to document API docs (#67843) 2021-01-25 09:46:09 -05:00
eql [DOCS] EQL: Add case-insensitive ~ operator (#68217) 2021-01-29 13:50:57 -05:00
graph [DOCS] Fix API titles (#67475) 2021-01-13 15:15:37 -05:00
high-availability Adjust resiliency docs for searchable snapshots (#67630) 2021-01-19 17:40:49 +00:00
how-to Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00:00
ilm Support max_single_primary_size in Resize Action and exposed in ILM (#67705) 2021-01-29 15:29:45 -05:00
images [DOCS] Update data streams list screenshots and description of "delete data stream" (#67145) 2021-01-07 16:45:26 +01:00
index-modules [DOCS] Fix some typos in docs (#66672) 2020-12-21 12:45:51 +02:00
indices Support max_single_primary_size in Resize Action and exposed in ILM (#67705) 2021-01-29 15:29:45 -05:00
ingest [DOCS] Network direction processor (#67943) 2021-01-26 09:33:47 -06:00
licensing [DOCS] Fix case for 'Boolean' (#64299) 2020-10-29 09:04:43 -04:00
mapping [DOCS] Add beta admonition for runtime fields. (#67847) 2021-01-21 17:10:37 -05:00
migration [DOCS] Add security privileges to API docs (#67939) 2021-01-27 09:06:06 -05:00
ml [ML] Add early stopping DFA configuration parameter (#68099) 2021-02-01 11:41:28 +01:00
modules Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00:00
monitoring [DOCS] Clarify elasticsearch module for Stack monitoring (#64497) 2021-01-19 16:14:46 -08:00
query-dsl Add support for Spatial Relationships to geo_point field (#67631) 2021-01-20 13:18:28 +01:00
release-notes Fix range query on date fields for number inputs (#63692) 2020-12-01 18:49:50 +01:00
repositories-metering-api [DOCS] Add security privileges to repositories monitoring API docs (#67944) 2021-01-26 09:05:56 -05:00
rest-api Logstash Pipeline REST api spec and documentation (#67788) 2021-01-28 10:50:16 -07:00
rollup [DOCS] Fix typo (#68129) 2021-01-28 17:07:01 -05:00
scripting [DOCS] Fix ingest script compilation rate and cache size (#61468) 2020-08-24 10:26:38 -04:00
search [DOCS] Fix title abbrevs for API docs (#68118) 2021-01-28 10:28:41 -05:00
searchable-snapshots [DOCS] Fix typo (#68085) (#68158) 2021-01-28 16:46:10 -05:00
settings [DOCS] Clarifies default ML and transform node settings (#67671) 2021-01-19 14:19:37 -08:00
setup Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00:00
slm [DOCS] Fix SLM security privilege wording (#68238) 2021-01-29 16:48:14 -05:00
snapshot-restore Introduce repository UUIDs (#67829) 2021-01-25 12:17:52 +00:00
sql QL: Implement support for date_nanos ES type. (#67666) 2021-01-29 11:07:29 +01:00
tab-widgets [DOCS] Improve docs for Windows DOS/UNC paths in path.* settings (#64668) 2020-11-09 10:36:48 -05:00
text-structure/apis [ML] [DOCS] update find-structure reference docs (#67586) 2021-01-15 12:19:38 -05:00
transform [Transform] Add support for search-time runtime fields. (#67643) 2021-01-21 13:27:42 +01:00
upgrade [DOCS] Make cat API verbose query param explicit (#67300) 2021-01-11 17:19:23 -05:00
vectors [DOCS] Update my-index examples (#60132) 2020-07-27 14:46:39 -04:00
aggregations.asciidoc [DOCS] Rewrite aggs overview (#64318) 2020-10-30 08:39:38 -04:00
analysis.asciidoc [DOCS] Swap [float] for [discrete] (#60124) 2020-07-23 11:48:22 -04:00
api-conventions.asciidoc Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00:00
cat.asciidoc [DOCS] Fix cat API list order (#67486) 2021-01-13 16:41:44 -05:00
cluster.asciidoc Password-protected Keystore Feature Branch PR (#51123) 2020-01-27 19:51:39 -05:00
data-management.asciidoc [DOCS] Move Kibana index mgmt docs to ES (#64380) 2020-10-30 09:14:52 -04:00
data-rollup-transform.asciidoc [DOCS] Changes level offset of transform pages (#60066) 2020-07-22 10:55:48 -07:00
datatiers.asciidoc Cold tier time-range should not be specified (#65546) 2020-11-30 15:04:41 +01:00
dependencies-versions.asciidoc [DOCS] Added appendix to show dependencies (#67962) 2021-01-26 16:16:05 -08:00
docs.asciidoc [DOCS] Remove heading offsets for REST APIs (#44568) 2019-07-19 14:35:36 -04:00
frozen-indices.asciidoc [DOCS] Make cat API verbose query param explicit (#67300) 2021-01-11 17:19:23 -05:00
getting-started.asciidoc [DOCS] Make cat API verbose query param explicit (#67300) 2021-01-11 17:19:23 -05:00
glossary.asciidoc [DOCS] Add xrefs to rollup overview (#68119) 2021-01-28 10:37:30 -05:00
gs-index.asciidoc [DOCS] Adding index file for GS "mini book". 2017-07-18 13:44:08 -07:00
high-availability.asciidoc [DOCS] Add docs for designing resilient clusters (#47233) 2020-06-05 11:48:44 -04:00
how-to.asciidoc [DOCS] Document shard sizing guide (#61942) 2020-09-28 09:24:40 -04: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 [DOCS] Update CCR docs to focus on Kibana (#60555) 2020-08-17 15:36:54 -04:00
index.asciidoc [DOCS] Added appendix to show dependencies (#67962) 2021-01-26 16:16:05 -08:00
index.x.asciidoc [DOCS] Removes redundant index.asciidoc files (#30707) 2018-05-18 11:05:40 -07:00
indices.asciidoc [DOCS] Mark template exists API as legacy (#67286) 2021-01-11 14:14:44 -05:00
ingest.asciidoc [DOCS] Fix ingest node.roles example (#66287) 2020-12-15 08:19:54 -05:00
intro.asciidoc [DOCS] Update rollup xrefs (#66799) 2020-12-23 13:49:15 -05:00
links.asciidoc [DOCS] Fix security links in machine learning APIs (#60098) 2020-07-23 12:14:56 -07:00
mapping.asciidoc Minor revision missed in merge. (#67282) 2021-01-11 13:50:06 -05:00
query-dsl.asciidoc [DOCS] Add redirects for wildcard and constant keyword (#61815) 2020-09-01 15:32:35 -04:00
redirects.asciidoc Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00: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] Swap [float] for [discrete] (#60124) 2020-07-23 11:48:22 -04:00
search.asciidoc [DOCS] Display point in time API docs (#61527) 2020-08-25 11:03:41 -04:00
setup.asciidoc Expand and consolidate networking docs (#68051) 2021-02-01 13:06:20 +00:00
upgrade.asciidoc [DOCS] Add tip for upgrade assistant (#55027) 2020-05-05 09:49:22 -04:00