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.

NHibernate Persistence Upgrade Version 10 to 11

This is part of the NServiceBus Upgrade Guide from Version 9 to 10, which also includes the following individual upgrade guides for specific components:

Transports
Persistence
Other

Saga mapping loading with disabled assembly scanning

When assembly scanning is disabled, saga mapping discovery has been tightened. Previously, all assemblies discovered via GetAvailableTypes() were registered with NHibernate, allowing saga mappings to be picked up from any scanned assembly, even if it did not contain saga entities. Now, saga entity types are resolved first from the registered saga metadata, and only assemblies that actually contain those saga entities are treated as the authoritative source of mappings.

As a result, NHibernate no longer pulls in unrelated mappings from arbitrary scanned assemblies. If you rely on saga-related mappings that live in assemblies which do not directly contain saga entities, those mappings must now be manually registered with NHibernate to ensure they are included.

Related Articles

In this article