High level REST client backwards compatibility

In the transport client documentation I see this statement:

The client must have the same major version (e.g. 2.x , or 5.x ) as the nodes in the cluster. Clients may connect to clusters which have a different minor version (e.g. 2.3.x ) but it is possible that new functionality may not be supported. Ideally, the client should have the same version as the cluster.

In the docs for the new java client (currently being developed) I see this:

The Elasticsearch Java client is forward compatible; meaning that the client supports communicating with greater minor versions of Elasticsearch. Elastic language clients are also backwards compatible with lesser supported minor Elasticsearch versions.

Both of these statements convey backwards compatibility for minor versions.

But I don't see such a statement in the documentation for the java high level rest client here: Compatibility | Java REST Client [7.x] | Elastic

I'm currently using the java high level REST client version 7.11.1 on ES nodes running 7.11.1. I'd like to update to the java high level REST client libraries to 7.14.1.

Is it required that I upgrade my ES nodes to 7.14.1 before updating the java client libraries to 7.14.1? Or would things work fine if the 7.14.1 client libraries are used to talk to the 7.11.1 ES nodes? Or is the behavior unknown?

If you want to upgrade the client you should (must) upgrade the server.

You can upgrade the server without upgrading the client. But if you upgrade the client, you should really upgrade the server.

Ideally always keep the versions in sync.

1 Like

Thanks @dadoonet. So if I'm understanding correctly, this statement here will be true of the new client but is not true of the high level REST client today.

In other words, if I were on the new java client, there would be no problem using the 7.14.1 client to talk to a 7.11.1 server. But today with the high level REST client this isn't supported.

Does that sound right?

Yes. That sounds right. @swallez might confirm.

1 Like

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.