13.13. Compatibility Between Server and Hot Rod Client Versions

download PDF
Hot Rod clients, such as the Hot Rod Java, Hot Rod C++, and Hot Rod C#, are compatible with different versions of Red Hat JBoss Data Grid server. The server should be of the latest version in order to run with different Hot Rod clients.


It is recommended to use the same version of the Hot Rod client and the JBoss Data Grid server, except in a case of migration or upgrade, to prevent any known problems.
Consider the following scenarios.
Scenario 1: Server running on a newer version than the Hot Rod client.

The following will be the impact on the client side:

  • client will not have advantage of the latest protocol improvements.
  • client might run into known issues which are fixed for the server-side version.
  • client can only use the functionalities available in its current version and the previous versions.
Scenario 2: Hot Rod client running on a newer version than the server.

In this case, when a Hot Rod client connects to a JBoss Data Grid server, the connection will be rejected with an exception error. The client can be downgraded to a known protocol version by setting the client side property - org.infinispan.client.hotrod.configuration.ConfigurationBuilder.protocolVersion to a specific version, such as Hot Rod 1.3, as a String. In this case the client is able to connect to the server, but will be restricted to the functionality of that version. Any command which is not supported by this protocol version will not work and throw an exception. Also, the topology information might be inefficient in this case.


It is not recommended to use this approach without guidance from Red Hat support.
The following table details the compatibility between different Hor Rod client and server versions.
Table 13.47. Hot Rod client and server compatibility
JBoss Data Grid Server Version Hot Rod Protocol Version
JBoss Data Grid 6.6.1 Hot Rod 2.3
JBoss Data Grid 6.6.0 Hot Rod 2.3
JBoss Data Grid 6.5.1 Hot Rod 2.2
JBoss Data Grid 6.5.0 Hot Rod 2.2
JBoss Data Grid 6.4.1 Hot Rod 2.0
JBoss Data Grid 6.4.0 Hot Rod 2.0
JBoss Data Grid 6.3.2 Hot Rod 2.0
JBoss Data Grid 6.3.1 Hot Rod 2.0
JBoss Data Grid 6.3.0 Hot Rod 2.0
JBoss Data Grid 6.2.1 Hot Rod 1.3
JBoss Data Grid 6.2.0 Hot Rod 1.3
JBoss Data Grid 6.1.0 Hot Rod 1.2
JBoss Data Grid 6.0.1 Hot Rod 1.1
JBoss Data Grid 6.0.0 Hot Rod 1.1
Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.