11.11. Compatibility Between Server and Hot Rod Client Versions
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.
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 either setting the client side property
infinispan.client.hotrod.protocol_version, or by using the
protocolVersion(String version) method. When downgraded the client version using either of these methods a
String containing the desired version should be passed in. 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; in addition, the topology information might be inefficient in this case.
Example 11.12. Downgrading Client Hot Rod Protocol Version
Configuration config = new ConfigurationBuilder() [...] .protocolVersion("2.2") .build();
Table 11.80. Hot Rod protocol and server compatibility
|JBoss Data Grid Server Version||Hot Rod Protocol Version|
|JBoss Data Grid 7.0.0||Hot Rod 2.5 and later|