Skip to content

Commit 1a099fa

Browse files
authored
[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 3ba5566 commit 1a099fa

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
@@ -47,6 +47,16 @@ is returned. Use the `size` and `from` parameters to enumerate through the full
4747
list.
4848

4949

50+
[float]
51+
[[transform-node-assignment-limitations]]
52+
==== {transforms-cap} node assignment not configurable
53+
54+
{transforms-cap} persistent tasks are assigned to the data node running
55+
fewest persistent tasks at the time of assignment. This cannot be customized.
56+
It means that if {transforms} are being used then `xpack.transform.enabled`
57+
must be set to `true` (which is the default) on every data node in the cluster.
58+
59+
5060
[float]
5161
[[transform-aggresponse-limitations]]
5262
==== Aggregation responses may be incompatible with destination index mappings

0 commit comments

Comments
 (0)