Support Policy

Supported Versions

Supported versions of NServiceBus and its associated packages are determined by the release date of the package that replaces them. After a specific version of a package is replaced by a newer version, the older package will remain supported for a fixed period of time afterward. This enables starting a project with the newest versions at the time, with the confidence that those versions will be supported well into the future, regardless of the release schedule for new components.

NServiceBus package

  • Major versions are supported for a period of 2 years after the release of the next major version.
  • Minor versions of a supported major version are supported for a period of 6 months after the release of the next minor version.
  • Only the latest patch release of each supported minor version is supported.

Component packages that depend upon NServiceBus

  • Major versions are supported for a period of 1 year after the release of the next major version.
  • Minor versions of a supported major version are supported for a period of 3 months after the release of the next minor version.
  • Only the latest patch release of each supported minor version is supported.
  • A version can only be supported if the NServiceBus package on which it depends is also currently supported.
  • If the version is the most recent version which works with a given version of NServiceBus, the version will be supported for as long as that version of NServiceBus is supported.
If support is required for a version that is not listed or has expired, contact Particular Software Support.

Particular will apply critical bug fixes to all supported versions. If the bug also impacts a non supported version, the recommended approach is to upgrade to a supported version which contains the fix.

For more information refer to the release policy.

NServiceBus

VersionReleasedSupported untilNotes
6.4.x2017-08-18--
6.3.x2017-05-192018-02-18Superseded by 6.4.x
6.2.x2017-03-282017-11-19Superseded by 6.3.x
6.1.x2016-12-132017-09-28Superseded by 6.2.x
6.0.x2016-10-112017-06-13Superseded by 6.1.x
5.2.x2015-02-122018-10-11Superseded by 6.0.x

For other NServiceBus packages, refer to the list of supported versions of all packages.

Compatibility guarantees

All new features are backwards compatible by default. In the rare cases when this is not possible, the new feature would be disabled by default and require an explicit opt-in to be enabled. These types of features are covered in the Upgrade Guide for the new target version.

Upgrading

NServiceBus versions are wire-compatible, meaning the endpoints using different versions can exchange messages with each other.

However, some features might require data migration (e.g. converting from old to new format), and the conversion might be performed in the background after upgrade.

Therefore the recommended approach is to upgrade 1 major version at a time, including a full regression testing of the system and deployment to production.

FAQ

Does this policy apply to the ServiceControl, ServiceInsight, or ServicePulse applications?

No, the policy applies only to the supported NServiceBus packages listed on the NServiceBus Packages Supported Versions page.

Which version of NServiceBus should be used to start a new project?

It's preferable to use the newest major version of NServiceBus when starting a new project. The support policy guarantees that the major version will be supported for at least 2 years after it is replaced by a new major version.

Why are fixes backported to old minor versions?

In accordance with the release policy, important fixes are backported to older (but still supported) minor versions to reduce the risk of upgrading. A component can be upgraded to a newer patch release without requiring an upgrade to the newest minor version containing new functionality.

Why are support intervals for NServiceBus longer than for component packages?

Component packages, such as transports, persistence, dependency injection, or serializers, have much less upgrade risk than the NServiceBus package. Therefore, the commitment to backporting fixes affecting the NServiceBus package is higher than for the many component packages.

The support dates for NServiceBus and each component package can be found on the supported versions page.

Related Articles


Last modified