소스 검색

[DOCS] Clarifies transform node settings (#59023)

Lisa Cawley 5 년 전
부모
커밋
fca1ece693
3개의 변경된 파일11개의 추가작업 그리고 16개의 파일을 삭제
  1. 4 7
      docs/reference/modules/node.asciidoc
  2. 3 1
      docs/reference/settings/transform-settings.asciidoc
  3. 4 8
      docs/reference/transform/setup.asciidoc

+ 4 - 7
docs/reference/modules/node.asciidoc

@@ -15,7 +15,7 @@ All nodes know about all the other nodes in the cluster and can forward client
 requests to the appropriate node.
 
 By default, a node is all of the following types: master-eligible, data, ingest,
-and (if available) machine learning and transform.
+and (if available) machine learning. All data nodes are also transform nodes.
 // end::modules-node-description-tag[]
 TIP: As the cluster grows and in particular if you have large {ml} jobs or
 {ctransforms}, consider separating dedicated master-eligible nodes from
@@ -259,12 +259,9 @@ xpack.ml.enabled: true <1>
 [[transform-node]]
 ==== [xpack]#{transform-cap} node#
 
-{transform-cap} nodes run {transforms} and handle {transform} API requests.
-
-If you want to use {transforms} in clients (including {kib}), it must also be
-enabled on all coordinating nodes. You must also have at least one node with the
-`transform` role. This is the default behavior. If you have the {oss-dist}, do
-not use these settings. For more information, see <<transform-settings>>.
+{transform-cap} nodes run {transforms} and handle {transform} API requests. By
+default, data nodes are also transform nodes. If you have the {oss-dist}, do not
+use these settings. For more information, see <<transform-settings>>.
 
 To create a dedicated {transform} node in the {default-dist}, set:
 

+ 3 - 1
docs/reference/settings/transform-settings.asciidoc

@@ -7,7 +7,8 @@
 <titleabbrev>{transforms-cap} settings</titleabbrev>
 ++++
 
-You do not need to configure any settings to use {transforms}. It is enabled by default.
+You do not need to configure any settings to use {transforms}. It is enabled by
+default.
 
 All of these settings can be added to the `elasticsearch.yml` configuration file.
 The dynamic settings can also be updated across a cluster with the
@@ -21,6 +22,7 @@ file.
 ==== General {transforms} settings
 
 `node.transform`::
+deprecated:[7.9.0,"Use <<modules-node,node.roles>> instead."]
 Set to `true` to identify the node as a _transform node_. If `node.data`
 is `false` for the node, the default value is `false`. Otherwise, the default
 value is `true`.

+ 4 - 8
docs/reference/transform/setup.asciidoc

@@ -15,14 +15,10 @@ To use the {transforms}, you must have the
 [[transform-setup-nodes]]
 ==== {transform-cap} nodes
 
-To use {transforms}, there must be at least one node in your cluster with
-`node.transform` set to `true`. By default, all nodes are {transform} nodes
-unless you explicitly change these settings or set `node.data` to `false`.
-
-If you want to control which nodes run {transforms}, set `node.transform` to
-`false` on some nodes.
-
-For more information, see <<transform-settings>> and <<modules-node>>.
+To use {transforms}, there must be at least one {transform} node in your cluster.
+If you want to control which nodes run {transforms}, add or remove `transform`
+from the `node.roles` setting on some nodes. For more information, see
+<<modules-node>> and <<transform-settings>>.
 
 [discrete]
 [[transform-privileges]]