Expand Collapse
Just a second...

Interoperability

If you plan to use different versions of Diffusion™ servers and clients together, review the following information that summarizes support between versions.

Support for new topic types

Diffusion version 5.7 introduced the following new topic types: JSON and binary. These topic types are not supported by previous versions of Diffusion or by Classic API clients in any version.

If you use JSON or binary topics, ensure that you use 5.7 or later and that you use the Unified API. Attempting to use the Classic API with JSON or binary topics is not supported and results in undefined behavior.

Interoperation between clients and servers

The following table describes which Unified API client versions interoperate with which server versions.

Note: Interoperability is only tested and guaranteed between the Diffusion server and clients of the same version and the immediately previous version. For example, 5.9 clients and 5.8 clients are certified to work with a 5.9 Diffusion server. All older clients are supported on a best-effort basis, unless explicitly marked as unsupported in the following table.
Table 1. Unified API interoperation
  Server version
Client version 5.1 5.6 5.7 5.8 5.9
5.1 Unified API Supported Not supported Not supported Not supported Not supported
5.6 Unified API Not supported Supported Supported Supported Supported
5.7 Unified API Not supported Not supported Supported Supported Supported
5.8 Unified API Not supported Not supported Not supported Supported Supported
5.9 Unified API Not supported Not supported Not supported Not supported Supported
The following table describes which Classic API client versions interoperate with which server versions:
Table 2. Classic API (deprecated) interoperation
  Server version
Client version 5.1 5.6 5.7 5.8 5.9
5.1 Classic API Supported Supported Supported Supported Supported
5.6 Classic API Supported Supported Supported Supported Supported
5.7 Classic API Supported Supported Supported Supported Supported
5.8 Classic API Supported Supported Supported Supported Supported
5.9 Classic API Supported Supported Supported Supported Supported

Interoperation between servers

Replication

All Diffusion servers within a cluster must be of the same level.

Server versions 5.1 5.6 5.7 5.8 5.9
5.1 Supported Not supported Not supported Not supported Not supported
5.6 Not supported Supported Not supported Not supported Not supported
5.7 Not supported Not supported Supported Not supported Not supported
5.8 Not supported Not supported Not supported Supported Not supported
5.9 Not supported Not supported Not supported Not supported SupportedSee note
Note: If some of the Diffusion servers in your cluster are version 5.9.4 and earlier and others are 5.9.5 and later, this change can cause inconsistent behaviors when replicating branches of the topic tree that contain slave topics. To ensure consistent behavior when replicating slave topics, update all of your Diffusion servers to 5.9.5 and later.
Fan out

All servers later than 5.6 interoperate.

To receive propagated missing topic notifications through fan-out connections, all servers must be version 5.9 or later.

Server versions 5.1 5.6 5.7 5.8 5.9
5.1 Not supported Not supported Not supported Not supported Not supported
5.6 Not supported Supported Supported Supported Supported
5.7 Not supported Supported Supported Supported Supported
5.8 Not supported Supported Supported Supported Supported
5.9 Not supported Supported Supported Supported Supported
Publishers

DEPRECATED: Publishers deployed to Diffusion servers can connect to and communicate with publishers deployed to Diffusion servers of different versions.

Server versions 5.1 5.6 5.7 5.8 5.9
5.1 Supported Supported Supported Supported Supported
5.6 Supported Supported Supported Supported Supported
5.7 Supported Supported Supported Supported Supported
5.8 Supported Supported Supported Supported Supported
5.9 Supported Supported Supported Supported Supported

This page last modified: 2016/10/05