Skip to content

Commit db129d0

Browse files
committed
[DOCS] Correct important note for xpack.transform.enabled (#52194)
Because transforms get assigned to an arbitrary data node it is important that the transforms plugin is enabled on every data node.
1 parent da1c4d6 commit db129d0

File tree

2 files changed

+12
-2
lines changed

2 files changed

+12
-2
lines changed

docs/reference/settings/data-frames-settings.asciidoc

+2-2
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@ Therefore the node cannot start or administrate {transform} or receive transport
2828
communication requests related to {transform} APIs.
2929
+
3030
IMPORTANT: If you want to use {transform} features in your cluster, you must have
31-
`xpack.transform.enabled` set to `true` on all master-eligible nodes. This is the
32-
default behavior.
31+
`xpack.transform.enabled` set to `true` on all master-eligible nodes and all data nodes.
32+
This is the default behavior.
3333

3434
`xpack.transform.num_transform_failure_retries` (<<cluster-update-settings,Dynamic>>)::
3535
The number of times that a {transform} retries when it experiences a

docs/reference/transform/limitations.asciidoc

+10
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,16 @@ is returned. Use the `size` and `from` parameters to enumerate through the full
6868
list.
6969

7070

71+
[float]
72+
[[transform-node-assignment-limitations]]
73+
==== {transforms-cap} node assignment not configurable
74+
75+
{transforms-cap} persistent tasks are assigned to the data node running
76+
fewest persistent tasks at the time of assignment. This cannot be customized.
77+
It means that if {transforms} are being used then `xpack.transform.enabled`
78+
must be set to `true` (which is the default) on every data node in the cluster.
79+
80+
7181
[float]
7282
[[transform-aggresponse-limitations]]
7383
==== Aggregation responses may be incompatible with destination index mappings

0 commit comments

Comments
 (0)