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 two years after the release of the next major version.
  • Minor versions of a supported major version are supported for a period of six 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 one year after the release of the next major version.
  • Minor versions of a supported major version are supported for a period of three 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 a 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
7.2.x2019-10-23--
7.1.x2018-08-302020-04-23Superseded by 7.2.x
7.0.x2018-05-292019-02-28Superseded by 7.1.x
6.5.x2018-08-302020-05-29Superseded by 7.0.x
6.4.x2017-08-182019-02-28Superseded by 6.5.x
5.2.x2015-02-122018-10-11Extended support until 2020-10-11

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

Extended support

Extended support is offered on major versions of NServiceBus for a period of 2 years after the expiration of mainstream support, for an additional fee. Because major versions of NServiceBus are generally supported for at least 3 years (or longer, depending upon the cadence of NServiceBus major releases), extended support affords the peace of mind that a major version of NServiceBus will be supported for at least 5 years. To qualify for extended support, a valid support agreement with Particular Software is required.

During the extended support period:

  • Documentation is provided for versions under mainstream and extended support.
  • Samples for extended support versions are available only for customers with an extended support agreement, upon request.
  • Patches for critical bugs on extended support versions will only be provided to customers with an extended support agreement.

The following table describes the extended support status for all major versions:

VersionReleasedCurrent SupportMainstream Support ExpiresExtended Support Expires
NServiceBus 72018-03-30MainstreamCurrent VersionCurrent Version
NServiceBus 62016-10-11Mainstream2020-05-292022-05-29
NServiceBus 52014-09-29Extended2018-10-112020-10-12
NServiceBus 42013-07-11Unsupported2016-09-292018-09-29
NServiceBus 32012-03-08Unsupported2015-07-112017-07-11

Compatibility guarantees

All new features are backward compatible by default. In rare cases when this is not possible, the new feature will be disabled by default and require an explicit opt-in in order to be enabled. These features are covered in the upgrade guide for the new target version.

Upgrading

NServiceBus versions are wire-compatible; endpoints using different versions of NServiceBus can exchange messages with each other.

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

Therefore the recommended approach is to upgrade one major version at a time, including a full regression test of the system and deployment to production after each major version upgrade.

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. The ServiceControl support policy is outlined here.

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

It's recommended 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 two 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, persisters, 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