This page last changed on Apr 06, 2007 by mmccorma.
virtualhosts.xml Overview
This configuration file contains details of all queues and topics, and associated properties, to be created on broker startup. These details are configured on a per virtual host basis.
Note that if you do not add details of a queue or topic you intend to use to this file, you must first create a consumer on a queue/topic before you can publish to it using Qpid.
Thus most application deployments need a virtualhosts.xml file with at least some minimal detail.
XML Format with Comments
The virtualhosts.xml which currently ships as part of the Qpid distribution is really targeted at development use, and supports various artifacts commonly used by the Qpid development team.
As a result, it is reasonably complex. In the example XML below, I have tried to simplify one example virtual host setup which is possibly more useful for new users of Qpid or development teams looking to simply make use of the Qpid broker in their deployment.
I have also added some inline comments on each section, which should give some extra information on the purpose of the various elements.
Using your own virtualhosts.xml
Note that the config.xml file shipped as an example (or developer default) in the Qpid distribution contains an element which defines the path to the virtualhosts.xml.
When using your own virtualhosts.xml you must edit this path to point at the location of your file.
|