AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/persistence/llms.txt. The markdown version of this page is served as plain text. An MCP server at /mcp serves the same content via the search_docs and read_doc tools; it is read-only and needs no credentials. Markdown versions of documentation pages are available by appending .md to the page URL. Directory URLs use index.md. They are served as text/plain because some retrieval backends reject text/markdown.

NServiceBus Gateway RavenDB Persistence Upgrade from 1 to 2

Cluster-wide transactions support

NServiceBus.Gateway.RavenDB version 2 supports cluster-wide transactions. RavenDB 5.2 or greater is required for both the RavenDB client and server. Cluster-wide transaction support is disabled by default. To enable it, configure the persister as follows:

var ravenGatewayDeduplicationConfiguration = new RavenGatewayDeduplicationConfiguration((builder, _) =>
{
   //create and configure the RavenDB document store.
})
{
   EnableClusterWideTransactions = true
};

If the persister is configured to connect to a database whose replication factor is greater than one, and cluster-wide transaction are not enabled, the persister will throw the following exception:

The configured database is replicated across multiple nodes, in order to continue, use EnableClusterWideTransactions on the gateway configuration.

Related Articles

  • Gateway
    Durable fire-and-forget messaging across physically separated IT infrastructure.
  • RavenDB Gateway Storage
    RavenDB deduplication storage for the gateway component.

In this article