Documentation question

Hey guys, im trying to read through the docs to understand what a production grade deployment needs , anyways

I have reached the part where im reading about node roles

Now - there is something rather confusing to me in the documentation

At the 2nd+3rd sentence in the "Node role Settings" title, it says:
" If you set node.roles , the node is only assigned the roles you specify. If you don’t set node.roles , the node is assigned the following roles:"

right below that, after the list of node roles available, you see this sentence

Doesn't this contradict the sentence that says "If you don't set node.roles, the node is assigned the following roles:"
and than list master\data as one of the defualt assigned roles,
Why would the node be considered coordinating only node, if it has a "master" role for example ?

Or am i missing something?

Thanks in advance for any help! :slight_smile:
cheers

Yeah, the way the documentation is now can be a little confusing.

But the first part is about not having node.roles present in elasticsearch.yml and the second is about having it in elasticsearch.yml but not setting any value to it.

If you do not add a node.roles in elasticsearch.yml it will get the listed roles, but if you add node.roles in elasticsearch.yml but does not set any role, it will act as a coordinating only node.

I agree with @alon_hen , the documentation for this is poor.

I happened to know how it worked, but it's trying to invent some sort of difference between between

"If you don't set node.roles"
and
"If you leave node.roles unset, then"

which is nonsense.

The latter really means "if you set to an empty list, node.roles: [], then ...

1 Like

That line only seems to exist in the 8.17 docs (it's not in the 8.18 docs or the 8.16 ones).

From what I can tell, some things were moved around in the docs, and in order to keep links from breaking we needed to insert a statement about coordinating only nodes, and because it was done as an after-thought, the statement that was added was poorly worded.

We'll fix it.

1 Like

Thanks so much guys, understood! :slight_smile: