Chapter 6. Federation in MRG Messaging

Chapter 6. Federation in MRG Messaging

Federation is used to provide geographical distribution of brokers. A number of individual brokers, or clusters of brokers, can be federated together. This allows client machines to see and interact with the federation as though it were a single broker. Federation can also be used where client machines need to remain on a local network, even though their messages have to be routed out.

A number of individual brokers, or clusters of brokers, can be federated together.

Managing Federation with qpid-route

Federation can be managed from the command line with qpid-route, which can display and configure broker federation, including routing and links between brokers.

  1. The command line utilities are included in the python client library package. Follow the installation instructions in Chapter 1, Installing MRG Messaging and install the python-qpid and amqp packages.

  2. To view the available commands, use the --help option with the qpid-route command: 

    # qpid-route --help
Usage:  qpid-route [OPTIONS] link add  <dest-broker> <src-broker>
	qpid-route [OPTIONS] link del  <dest-broker> <src-broker>
	qpid-route [OPTIONS] link list <dest-broker>
					
	qpid-route [OPTIONS] route add   <dest-broker> <src-broker> <exchange> <routing-key> [id] [exclude-list]
	qpid-route [OPTIONS] route del   <dest-broker> <src-broker> <exchange> <routing-key>
	qpid-route [OPTIONS] route list  <dest-broker>
	qpid-route [OPTIONS] route flush <dest-broker>
Options for using qpid-route to Manage Federation
-v Verbose output.
-q Quiet output, will not print duplicate warnings.
-d Make the configuration change durable.
Table 6.1. Options for using qpid-route to Manage Federation