Upgrading from version 6.9 to version 6.10
Consider the following information when upgrading from Diffusion™ version 6.9 to version 6.10.
Upgrading your applications
- Server-side components
-
Recompile all Java™ application components that are deployed to the Diffusion server, such as 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.
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.
Note that the local install method for the Python client has changed. See the Client basics page for Python for details.
API changes
Further information about removed or deprecated features is available in the release notes provided online at http://docs.diffusiondata.com/docs/6.10.4/ReleaseNotice.html
API affected | Removed feature | Suggested alternative |
---|---|---|
All SDKs | The deprecated TopicAddFailReason.INCOMPATIBLE_PARENT and associated IncompatibleParentTopicException have been removed at this release from the Java SDK. Equivalents have also been removed from all other SDKs. | n/a |
All SDKs | TopicPermission was deprecated at release 6.5 in favor of PathPermission. It has been removed at this release along with all associated methods. | Use PathPermission |
All SDKs | ROUTING topics, which were deprecated in release 6.7, have been removed at this release. There is no longer support for routing topics in the server. | Users who were using routing topics should now use the more powerful 'Session trees' feature. |
Upgrading your server installation
- Use the graphical or headless installer to install the new version of
Diffusion
.
For more information, see Installing the Diffusion server.
- Contact DiffusionData for an updated license file.
- 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.