Just a second...

Upgrading from version 6.2 to version 6.3

Consider the following information when upgrading from Diffusion™ version 6.2 to version 6.3.

Upgrading your applications

Server-side components

Recompile all Java™ application components that are deployed to the Diffusion server, such as publishers and authorization handlers, against the new version diffusion.jar file. This file is located in the lib directory of your new Diffusion server installation.

Some features that your Java application components might use have been removed or deprecated. Pay attention to new deprecation warnings and compilation failures that occur during recompilation and review the API changes information in the following section to see if these changes affect your applications.

Clients

You can choose not to recompile your client applications and continue to use client libraries from a previous release. If you choose to use client libraries from a previous release, ensure that the libraries are compatible with the new server. For more information, see Interoperability.

You can choose to upgrade your client applications to use the new client libraries. To do this, recompile the client applications against the client libraries located in the clients directory of your new Diffusion server installation and repackage your client application with the new library.

The Java client now supports Java 9, 10 and 11. Java 8 is still required for the server.

Your client applications may use features that have been removed or deprecated. Review the API changes information in the following section to see if these changes affect your applications.

API changes

Further information about removed or deprecated features is available in following locations:
The following table lists API classes and methods that have been deprecated. If your application code uses these classes or methods, consider rewriting your application code to not include these features.
Table 1. API features deprecated in version 6.3
API affected Deprecated feature Suggested alternative
Publisher API PublisherStatistics Use clients instead of publishers.
Publisher API ClientStatistics Use JMX/Prometheus/console, metric collectors
Publisher API TopicStatistics Use JMX/Prometheus/console, metric collectors

Upgrading your server installation

To upgrade your Diffusion server installation, complete the following steps:
  1. Use the graphical or headless installer to install the new version of Diffusion .

    For more information, see Installing the Diffusion server.

  2. Contact DiffusionData for an updated license file.
  3. You can copy most of your existing configuration files from the etc directory of your previous installation to the etc directory of your new installation.

    The following configuration items are now deprecated. Consider removing them from your configuration files.

    • Statistics.xml: topic-statistics, publisher-statistics, reporters and server-statistics elements.
  4. The working copies of the Security.store and SystemAuthentication.store files are now stored in the persistence directory. Copy those files from the etc directory of your previous installation to the persistence directory of your new installation.
  5. The hazelcast.xml configuration file is now stored in the etc directory rather than the data directory. If you have customised hazelcast.xml, copy it from the data directory of your previous installation into etc in the new installation.

Behavior changes at the Diffusion server

Topic views, metric collectors and the security/system authentication stores are now replicated across a Diffusion cluster if any form of replication is enabled.

If you are using clustered servers, do not edit the security/sytem authentication store files directly. Update the content using a client.