This document provides an overview of NServiceBus, an open source integration framework that uses messaging patterns like publish/subscribe and request/response. It discusses NServiceBus architecture, installation, configuration, monitoring, and running it in a clustered environment. The key aspects are that NServiceBus uses MSMQ for messaging and supports features like publishing messages, distributing work, and implementing long-running workflows through sagas.

1. NServiceBus for Admins

2. Integration Framework Patterns2

3. BrokerAppAppBrokerAppAppApp

4. BusAppAppBusBusAppAppBusBus

5. Messaging Patterns

6. Publish & SubscribeSubscriptionsPublisherSubscriberBusSubscriberSubscriberBusBus

7. BusRequest & ResponseClientResponseBusRequestBus

8. DistributorWork ManagementDistributorWorkerBusWorkerWorkerBusBus

9. Saga(Workflow)StatePersistenceMain Business ProcessSub Process 3BusSub Process 1Sub Process 2BusBus

10. GatewaySite 2Site 1ServerClientHTTPGatewayGateway

11. Messaging/Integration Framework Selection CriteriaFeaturesPublish/SubscribeWork DistributionLong Running Business WorkflowsLives on existing infrastructureLow Learning CurveActively supportedCost Effective

12. Selected FrameworkNServiceBusOpen SourceFeature RichBuilt on MSMQ, MSDTC, and .NET

13. NServiceBus Architecture

14. Required SoftwareMSMQMSDTCNSB Bits.NET Framework 3.5 SP1RDBMSSubscription StorageVery small, SQL Server will do

15. MonitoringPerfMon CountersNSB“Critical Time” – how long has the oldest message been sitting in the queueLogsSCOMMSMQError Queue

16. LoggingConfigurable & managed by the developerIncludes standard mechanismsFilesEvent LogDatabaseCustom…

17. InstallationNServiceBus.Host.exe[/install (installs as a Windows Service)[/serviceName] (name in the registry)[/displayName] (display name in Mgr)[/description] (description in Mgr)[/instance] (another named instance)[/startManually] (don’t start the service)[/username] (account it runs as)[/password] (password of above user)[ProfileName] (name of the profile to use)

18. ProfilesModifies host behavior on startupLoggingSubscription StorageCan Create Custom ProfilesOOTB ProfilesLite: Console app, verbose logging, memory subscription storageIntegration: Console app, informational logging, MSMQ subscription storageProduction: Windows Service, error logging, database subscription storage

19. UninstallationNServiceBus.Host.exe[/uninstall[/serviceName][/instance]]

20. Application Level MSMQ Configuration<MsmqTransportConfig InputQueue="client“Queue messages are being received on ErrorQueue="error“Queue error messages are sent to NumberOfWorkerThreads="1“Number of threads used to process messagesMaxRetries="5“Max number of times to try and process a message />

21. Subscription Storage Configuration<MsmqSubscriptionStorageConfig Queue="subscriptions" />Queue to look for subscriptions<DBSubscriptionStorageConfig><NHibernateProperties><add Key="connection.provider" Value="NHibernate.Connection.DriverConnectionProvider"/><add Key="connection.driver_class" Value="NHibernate.Driver.SqlClientDriver"/> <add Key="connection.connection_string" Value="Server=.;Database=nservicebussubscriptions;Trusted_Connection=True;"/><add Key="dialect" Value="NHibernate.Dialect.MsSql2005Dialect"/></NHibernateProperties> </DBSubscriptionStorageConfig>

22. ToolsReturnToSourceQueue.exeReplays messages to the queue they came fromRunner.exeValidates and fixes MSMQ installationsStarts MSDTC if necessaryInstalls NSB performance counters

23. Running in a ClusterYou need to add the .NET Framework feature or application server role to the member serversYou need to add both a MSDTC and a MSMQ resource to the cluster (MSMQ will require that you have MSDTC)After adding the Generic Application for NServiceBus.Host.exe, you will need to go in and modify the properties of the generic application to check the "Use Network Name for computer name" box so that NServiceBus points to the cluster name for using MSMQ not to the member server that is currently running it.

24. Questions?

25. Pub/Sub MechanicsPublisherSubscriptionsOutboundInboundReturnToSourceQueue.exeSubscriber1Subscriber2ErrorsInboundOutboundOutboundInboundInbound