Deploying distributors to a Windows Failover Cluster

Distributors are a single-point-of-failure if deployed to just a single machine. Make them highly available on a Windows Failover Cluster to avoid this.

The following procedure is a high-level guide on how to deploy distributors onto a Microsoft Windows Failover cluster.

  • This procedure assumes that the MSMQ transport uses distributed transactions (default). If running with SendsAtomicWithReceive all steps related to the Distributed Transaction Coordinator (MSDTC) can be skipped.
  • This procedure assumes only a single cluster group, meaning MSMQ and MSDTC are installed once on a cluster node. This results in both MSMQ and MSDTC will be active on the same node for improved performance and that it can never happen that MSMQ is active on node A and MSDTC is active on node B.

Windows Failover Cluster setup for distributors

  • Set up a Failover (active/passive) Windows Failover cluster:
  • Creating a Cluster in Windows Server 2008.
  • Creating a Cluster in Windows Server 2012R2 and Windows Server 2016.
  • Setup a new cluster group. A cluster Group is a group of resources that have a unique NETBIOS network name and can be addressed externally which is required for MSMQ.
  • Install clustered Message Queuing (MSMQ) and Distributed Transaction Coordinator (MSDTC) into the new cluster group.
  • Install the Message Queuing Services on each node.
  • Use the Failover Cluster Manager to add Message Queuing as a clustered role.
  • Use the Failover Cluster Manager to add MSDTC as a clustered role.
  • Install distributors as a clustered Generic Service.
  • Install the distributor as a standard windows service on each node.
  • Add it as a clustered "Generic service" using the Failover Cluster Manager.
  • Add dependencies to the following cluster group resources: network name, MSMQ, and MSDTC.
  • Check "use network name as computer name".
  • Repeat for each distributor.

Once set up, the clustered MSMQ queues and the distributors will be available on the network. Use the network name configured on the cluster group to reach them. Make sure to direct any send operations or messages subscriptions for endpoints using the distributor to the new network name.

More information on Message Queuing in Server Clusters.

Related Articles


Last modified