Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] add details on version compatibility and remote gateway selection #40056

Merged
merged 20 commits into from
Mar 18, 2019

Conversation

javanna
Copy link
Member

@javanna javanna commented Mar 14, 2019

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
@javanna javanna added >docs General docs changes v7.0.0 :Distributed Indexing/Distributed A catch all label for anything in the Distributed Area. Please avoid if you can. v6.7.0 v8.0.0 v7.2.0 labels Mar 14, 2019
@javanna javanna requested review from martijnvg and lcawl March 14, 2019 16:20
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-distributed

is referenced by a name and a list of seed nodes. When a remote cluster is
registered, its cluster state is retrieved from one of the seed nodes and up
to three _gateway nodes_ are selected to be connected to as part of remote
cluster requests. All the communication required between different clusters
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

three gateway nodes are selected to be connected to as part of remote cluster requests

It is unclear at this point in the page whether those three gateway nodes are used permanently or just for a particular request or whether the selection can change over time...?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They are used for all CCR and CCS requests from then on. The selection may change if one or more of those nodes are shut down, in that case they will get replaced.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, I think we should add that piece of info here.

@@ -211,4 +253,5 @@ PUT _cluster/settings

You can use the <<cluster-remote-info, remote cluster info API>> to retrieve
information about the configured remote clusters, as well as the remote nodes
that the node is connected to.
that the node is connected to. This is particularly useful to verify which
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as well as the remote nodes that the node is connected to.

The API reference information (https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-remote-info.html) implies that "connected" is true/false. Is that correct or does it list the gateway nodes?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

very good point. we do return a list of nodes but it's the list of seed nodes apparently rather than the selected gateway nodes, I need to adapt this then. Thanks for noticing!

Co-Authored-By: javanna <javanna@users.noreply.github.com>
lcawl and others added 10 commits March 15, 2019 17:04
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
Co-Authored-By: javanna <javanna@users.noreply.github.com>
version to the cluster on the lower version, since they support communicating with both ends. For instance, a 7.0
cluster can communicate with 6.6 or earlier nodes as long as at least one 6.7
_gateway node_ is present in their cluster. Beware that only features
supported by the lower version can be used in that case.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will remove this note, I got feedback that it may be problematic for CCR and I also find it a bit confusing.

Copy link
Member

@martijnvg martijnvg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@javanna javanna merged commit 87f4d3f into elastic:master Mar 18, 2019
javanna added a commit to javanna/elasticsearch that referenced this pull request Mar 19, 2019
…ion (elastic#40056)

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
javanna added a commit to javanna/elasticsearch that referenced this pull request Mar 19, 2019
…ion (elastic#40056)

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
javanna added a commit to javanna/elasticsearch that referenced this pull request Mar 19, 2019
…ion (elastic#40056)

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
This was referenced Mar 19, 2019
javanna added a commit that referenced this pull request Mar 19, 2019
…ion (#40056)

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
javanna added a commit that referenced this pull request Mar 19, 2019
…ion (#40056)

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
javanna added a commit that referenced this pull request Mar 19, 2019
…ion (#40056)

This commit clarifies how the gateway selection works when configuring
remote clusters for CCR or CCS. Specifically, it clarifies compatibility
between different versions which is a very common question.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:Distributed Indexing/Distributed A catch all label for anything in the Distributed Area. Please avoid if you can. >docs General docs changes v6.7.0 v7.0.0-rc1 v7.2.0 v8.0.0-alpha1
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants