Browse Source

[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.
David Roberts 5 years ago
parent
commit
1a099fa075

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

@@ -28,8 +28,8 @@ Therefore the node cannot start or administrate {transform} or receive transport
 communication requests related to {transform} APIs.
 +
 IMPORTANT: If you want to use {transform} features in your cluster, you must have
-`xpack.transform.enabled` set to `true` on all master-eligible nodes. This is the
-default behavior.
+`xpack.transform.enabled` set to `true` on all master-eligible nodes and all data nodes.
+This is the default behavior.
 
 `xpack.transform.num_transform_failure_retries` (<<cluster-update-settings,Dynamic>>)::
 The number of times that a {transform} retries when it experiences a

+ 10 - 0
docs/reference/transform/limitations.asciidoc

@@ -47,6 +47,16 @@ is returned. Use the `size` and `from` parameters to enumerate through the full
 list.
 
 
+[float]
+[[transform-node-assignment-limitations]]
+==== {transforms-cap} node assignment not configurable
+
+{transforms-cap} persistent tasks are assigned to the data node running
+fewest persistent tasks at the time of assignment. This cannot be customized.
+It means that if {transforms} are being used then `xpack.transform.enabled`
+must be set to `true` (which is the default) on every data node in the cluster.
+
+
 [float]
 [[transform-aggresponse-limitations]]
 ==== Aggregation responses may be incompatible with destination index mappings