summaryrefslogtreecommitdiff
path: root/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml
diff options
context:
space:
mode:
Diffstat (limited to 'qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml')
-rw-r--r--qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml131
1 files changed, 131 insertions, 0 deletions
diff --git a/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml b/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml
new file mode 100644
index 0000000000..690175d57e
--- /dev/null
+++ b/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml
@@ -0,0 +1,131 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+<section><title>
+ Configure the Virtual Hosts via virtualhosts.xml
+ </title><section role="h2" id="ConfiguretheVirtualHostsviavirtualhosts.xml-virtualhosts.xmlOverview"><title>
+ virtualhosts.xml Overview
+ </title>
+ <para>
+ 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.
+ </para><para>
+ 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.
+ </para><para>
+ Thus most application deployments need a virtualhosts.xml file
+ with at least some minimal detail.
+ </para>
+
+ <section role="h3" id="ConfiguretheVirtualHostsviavirtualhosts.xml-XMLFormatwithComments"><title>
+ XML Format with Comments
+ </title>
+ <para>
+ 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.
+ </para><para>
+ 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.
+ </para><para>
+ I have also added some inline comments on each section, which
+ should give some extra information on the purpose of the various
+ elements.
+ </para>
+
+
+
+ <programlisting>
+&lt;virtualhosts&gt;
+ &lt;!-- Sets the default virtual host for connections which do not specify a vh --&gt;
+ &lt;default&gt;localhost&lt;/default&gt;
+ &lt;!-- Define a virtual host and all it's config --&gt;
+ &lt;virtualhost&gt;
+ &lt;name&gt;localhost&lt;/name&gt;
+ &lt;localhost&gt;
+ &lt;!-- Define the types of additional AMQP exchange available for this vh --&gt;
+ &lt;!-- Always get amq.direct (for queues) and amq.topic (for topics) by default --&gt;
+ &lt;exchanges&gt;
+ &lt;!-- Example of declaring an additional exchanges type for developer use only --&gt;
+ &lt;exchange&gt;
+ &lt;type&gt;direct&lt;/type&gt;
+ &lt;name&gt;test.direct&lt;/name&gt;
+ &lt;durable&gt;true&lt;/durable&gt;
+ &lt;/exchange&gt;
+ &lt;/exchanges&gt;
+
+ &lt;!-- Define the set of queues to be created at broker startup --&gt;
+ &lt;queues&gt;
+ &lt;!-- The properties configured here will be applied as defaults to all --&gt;
+ &lt;!-- queues subsequently defined unless explicitly overridden --&gt;
+ &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+ &lt;!-- Set threshold values for queue monitor alerting to log --&gt;
+ &lt;maximumQueueDepth&gt;4235264&lt;/maximumQueueDepth&gt; &lt;!-- 4Mb --&gt;
+ &lt;maximumMessageSize&gt;2117632&lt;/maximumMessageSize&gt; &lt;!-- 2Mb --&gt;
+ &lt;maximumMessageAge&gt;600000&lt;/maximumMessageAge&gt; &lt;!-- 10 mins --&gt;
+
+ &lt;!-- Define a queue with all default settings --&gt;
+ &lt;queue&gt;
+ &lt;name&gt;ping&lt;/name&gt;
+ &lt;/queue&gt;
+ &lt;!-- Example definitions of queues with overriden settings --&gt;
+ &lt;queue&gt;
+ &lt;name&gt;test-queue&lt;/name&gt;
+ &lt;test-queue&gt;
+ &lt;exchange&gt;test.direct&lt;/exchange&gt;
+ &lt;durable&gt;true&lt;/durable&gt;
+ &lt;/test-queue&gt;
+ &lt;/queue&gt;
+ &lt;queue&gt;
+ &lt;name&gt;test-ping&lt;/name&gt;
+ &lt;test-ping&gt;
+ &lt;exchange&gt;test.direct&lt;/exchange&gt;
+ &lt;/test-ping&gt;
+ &lt;/queue&gt;
+ &lt;/queues&gt;
+ &lt;/localhost&gt;
+ &lt;/virtualhost&gt;
+&lt;/virtualhosts&gt;
+</programlisting>
+<!--h3--></section>
+ <section role="h3" id="ConfiguretheVirtualHostsviavirtualhosts.xml-Usingyourownvirtualhosts.xml"><title>
+ Using your own virtualhosts.xml
+ </title>
+
+ <para>
+ 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.
+ </para><para>
+ When using your own virtualhosts.xml you must edit this path to
+ point at the location of your file.
+ </para>
+<!--h3--></section>
+<!--h2--></section>
+</section>