Table Of Contents

Previous topic

2.1. Configuration

Next topic

2.3. Basic Usage and Examples

2.2. Tools

2.2.1. qdstat

qdstat is a command line tool that lets you view the status of a Dispatch Router. The following options are useful for seeing what the router is doing:

Option Description
-l Print a list of AMQP links attached to the router. Links are unidirectional. Outgoing links are usually associated with a subscription address. The tool distinguishes between endpoint links and router links. Endpoint links are attached to clients using the router. Router links are attached to other routers in a network of routbers.
-a Print a list of addresses known to the router.
-n Print a list of known routers in the network.
-c Print a list of connections to the router.
–autolinks Print a list of configured auto-links.
–linkroutes Print a list of configures link-routes.

For complete details see the qdstat(8) man page and the output of qdstat –help.

2.2.2. qdmanage

qdmanage is a general-purpose AMQP management client that allows you to not only view but modify the configuration of a running dispatch router.

For example you can query all the connection entities in the router:

$ qdmanage query --type connection

To enable logging debug and higher level messages by default:

$ qdmanage update log/DEFAULT enable=debug+

In fact, everything that can be configured in the configuration file can also be created in a running router via management. For example to create a new listener in a running router:

$ qdmanage create type=listener port=5555

Now you can connect to port 5555, for exampple:

$ qdmanage query -b localhost:5555 --type listener

For complete details see the qdmanage(8) man page and the output of qdmanage –help. Also for details of what can be configured see the qdrouterd.conf(5) man page.