This is part of the NServiceBus Upgrade Guide from Version 7 to 8, which also includes the following individual upgrade guides for specific components:
Feature Details
- Upgrading the data bus from version 7 to 8
- Dependency Injection changes
- Upgrade NServiceBus downstreams from Version 7 to 8
- Upgrading message contracts from Version 7 to 8
- Upgrade NServiceBus pipeline extensions from Version 7 to 8
- Transport configuration changes
Transports
- AmazonSQS Transport Upgrade Version 5 to 6
- Azure Service Bus Transport Upgrade Version 2 to 3
- Azure Storage Queues Transport Upgrade Version 10 to 11
- MSMQ Transport Upgrade Version 1 to 2
- MSMQ Transport Upgrade Version 2 to 2.0.4
- RabbitMQ Transport Upgrade Version 7 to 8
- SQL Server Transport Upgrade Version 6 to 7
Persistence
- Cosmos DB Persistence Upgrade from 1 to 2
- NHibernate Persistence Upgrade Version 8 to 9
- RavenDB Persistence Upgrade from 7 to 8
- SQL Persistence Upgrade Version 6 to 7
Hosting
Other
Gateway deduplication storage
Starting with NServiceBus.NHibernate version 8.3.0, the built-in gateway API is obsolete and using it will produce the following message:
NHibernate gateway persistence is deprecated. Use the new NServiceBus.Gateway.Sql dedicated package. Will be treated as an error from version 9.0.0. Will be removed in version 10.0.0.
To migrate to the new gateway API:
- Add a reference to the NServiceBus.Gateway.Sql NuGet package and configure the gateway feature following the instructions available in the SQL Gateway Storage documentation.
- Remove any configuration that uses the legacy gateway API.
Timeout storage
The timeout manager is removed from core which makes timeout storage obsolete.
- Any configuration APIs can safely be removed.
- Database tables must be manually removed from storage.
There is no automatic migration of timeout data. See Timeout manager removed - Data migration.