The distributor requires an additional queue where workers can send their status updates. This is the control queue. The default address is
The distributor stores metadata about the worker availability in the the queue with the suffix
When running with NServiceBus.Host.exe, the following profiles start the endpoint with the distributor functionality:
To start the endpoint as a Distributor, run the host from the command line as follows:
The NServiceBus.Distributor profile instructs the NServiceBus framework to start a distributor on this endpoint, waiting for workers to enlist to it. Unlike the NServiceBus.Master profile, the NServiceBus.Distributor profile does not execute a worker process.
It is also possible to use the
NServiceBus. profile to start distributor and worker processes on the endpoint. To start the endpoint as a master, run the host from the command line as follows:
When self hosting the endpoint, use this configuration:
// Running the Distributor and a Worker configure.AsMasterNode(); // or configure.RunDistributor(); // Running the Distributor only configure.RunDistributor(withWorker: false);
Any NServiceBus endpoint can run as a worker node. To activate it, create a handler for the relevant messages and ensure that the
app. file contains routing information for the distributor.
If hosting the endpoint with
NServiceBus., to run as a worker, use this command line:
Configure the name of the master node server as shown in this
app. example. Note the
<configuration> <configSections> <!-- Other sections go here --> <section name="MasterNodeConfig" type="NServiceBus.Config.MasterNodeConfig, NServiceBus.Core" /> </configSections> <!-- Other config options go here --> <MasterNodeConfig Node="MachineWhereDistributorRuns"/> </configuration>
For more information, see
DistributorDataAddress in the Override distributor queues (advanced) section.
When self-hosting the endpoint, the following code will enlist the endpoint with a distributor.
Similar to self-hosting, when running NServiceBus prior to version 6, ensure the
app. of the worker contains the
MasterNodeConfig section to point to the hostname where the distributor process is running.
The distributor can be used in combination with the outbox feature. Outbox must be enabled on the workers. It must also be enabled if a worker is configured as distributor master (distributor/worker combination). Outbox is required only for persistence operations; the forwarding of messages to workers is purely a transport operation and outbox will not participate in the forwarding logic.
The distributor process uses two queues for its runtime operation. The
DataInputQueue is the queue where the client processes send their messages. The
ControlInputQueue is the queue where the worker nodes send their control messages.
The NServiceBus default values for these settings can be overridden, as shown in the
UnicastBusConfig section below:
<UnicastBusConfig DistributorControlAddress="EndpointName.Distributor.Control@MachineWhereDistributorRuns" DistributorDataAddress="EndpointName@MachineWhereDistributorRuns"> <MessageEndpointMappings> <!-- regular entries --> </MessageEndpointMappings> </UnicastBusConfig>
Similar to standard NServiceBus routing, it is not desirable to have high priority messages to get stuck behind lower priority messages, so just as it is possible to have separate NServiceBus processes for different message types, it is also possible to set up different distributor process instances (with separate queues) for various message types.
In this case, name the queues after the message type. For example:
SubmitPurchaseOrder. becomes the name of the distributor data queue and the input queues of each of the workers.