Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The most popular, open-source service bus for .NET
C# JavaScript Other

This branch is 6 commits ahead, 7524 commits behind Particular:develop

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Documentation
Samples
external-bin
src
AllProjects.sln
NServiceBus.snk
acknowledgements.txt
build_samples.bat
build_src.bat
build_tools.bat
build_with_strong_name.bat
build_without_strong_name.bat
clean.bat
merge_assemblies.bat
msmq install.vbs
readme.txt

readme.txt

NServiceBus is a non-trivial framework that takes time to understand.

The best way to get up and running is from the Samples. Run them, change them a bit, look at what references what. If you want to do your own thing, copy one of the samples (like FullDuplex), and change from there.


============
= Building =
============

In order to build the source, run the relevant build.bat (build_with_strong_name.bat will generate assemblies with strong names - build_without_strong_name.bat will generate assemblies without strong names).

You'll find the built assemblies in /build/output.

The satellite processes (distributor, timeout manager, and tools) will be in the adjacent directories.

If you see CS1668 warning when building under 2008, go to the 'C:\Program Files\Microsoft SDKs\Windows\v6.0A' directory and create the 'lib' subdirectory.

If you see the build failing, check that you haven't put nServiceBus in a deep subdirectory since long path names (greater than 248 characters) aren't supported by MSBuild.

As of version 1.9, nServiceBus now merges Common.Logging so please make sure you go over your config files updating the assembly name to NServiceBus.

=====================
= MSMQ Installation =
=====================

1. In order to run some of the samples, MSMQ is required.

2. To install MSMQ, go to the Control Panel, Add or Remove Programs, Windows Components, Select "Message Queueing".

3. The minimal installation requires only "Common" and will work fine.

4. Run the script "msmq install.vbs" to install the queues used by the sample

=====================

In order to run samples that make use of sagas, specifically the DbBlobSagaPersister (found in \src\impl\SagaPersisters\DbBlobSagaPersister) or the DB subscription storage (found in \src\impl\unicast\NServiceBus.Unicast.Subscriptions.DB) you will need a database with the tables defined in TableDefinitions.txt.


Something went wrong with that request. Please try again.