You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by kw...@apache.org on 2013/10/09 00:56:29 UTC

svn commit: r1530457 [14/30] - in /qpid/site: docs/components/java-broker/book/ docs/components/java-broker/book/images/ input/components/java-broker/book/ input/components/java-broker/book/images/

Added: qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Declare-Queues.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Declare-Queues.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Declare-Queues.html (added)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Declare-Queues.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1,63 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>14.9. Configuring Queues</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Virtual-Hosts-Configuration-File.html" title="Chapter 14. Virtual Host XML configuration file"><link rel="prev" href="Java-Broker-Virtual-Host-Configuration-Exchange.html" title="14.8. Configuring Exchanges"><link rel="next" href="Java-Broker-Virtual-Host-Binding-Queue.html" title="14.10. Queue Binding"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><
 LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">So
 urce Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About
  Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html">Virtual Host XML configuration file</a></span> &gt; <span class="breadcrumb-node">Configuring Queues</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Virtual-Host-Declare-Queues"></a>14.9. Configuring Queues</h2></div></div></div><p>To create a priority, sorted or LVQ queue within configur
 ation, add the appropriate xml
+        to the virtualhost.xml configuration file within the <code class="varname">queues</code>
+        element.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Simple"></a>14.9.1. Simple</h3></div></div></div><p>For declaration of a simple queue define a queue entry in the virtual host configuration as in example below</p><div class="example"><a name="idp8047024"></a><p class="title"><b>Example 14.7. Configuring a simple queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+    &lt;name&gt;my-simple-queue&lt;/name&gt;
+    &lt;my-simple-queue&gt;
+        &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+        &lt;durable&gt;true&lt;/durable&gt;
+    &lt;/my-simple-queue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Priority"></a>14.9.2. Priority</h3></div></div></div><p> To defining a priority queue, add a &lt;priority&gt;true&lt;/priority&gt; element. By
+          default the queue will have 10 distinct priorities. </p><div class="example"><a name="idp8050352"></a><p class="title"><b>Example 14.8. Configuring a priority queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+    &lt;name&gt;myqueue&lt;/name&gt;
+    &lt;myqueue&gt;
+        &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+        &lt;priority&gt;true&lt;/priority&gt;
+    &lt;/myqueue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"><p> If you require fewer priorities, it is possible to specify a
+            <code class="varname">priorities</code> element (whose value is a integer value between 2 and 10
+          inclusive) which will give the queue that number of distinct priorities. When messages are
+          sent to that queue, their effective priority will be calculated by partitioning the
+          priority space. If the number of effective priorities is 2, then messages with priority
+          0-4 are treated the same as "lower priority" and messages with priority 5-9 are treated
+          equivalently as "higher priority". </p><div class="example"><a name="idp8053136"></a><p class="title"><b>Example 14.9. Configuring a priority queue with fewer priorities</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+    &lt;name&gt;myqueue&lt;/name&gt;
+    &lt;myqueue&gt;
+        &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+        &lt;priority&gt;true&lt;/priority&gt;
+        &lt;priorities&gt;4&lt;/priorities&gt;
+    &lt;/myqueue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Sorted"></a>14.9.3. Sorted</h3></div></div></div><p> To define a sorted queue, add a <code class="varname">sortKey</code> element. The value of the
+            <code class="varname">sortKey</code> element defines the message property to use the value of when
+          sorting the messages put onto the queue. </p><div class="example"><a name="idp8057392"></a><p class="title"><b>Example 14.10. Configuring a sorted queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+    &lt;name&gt;myqueue&lt;/name&gt;
+    &lt;myqueue&gt;
+        &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+        &lt;sortKey&gt;message-property-to-sort-by&lt;/sortKey&gt;
+    &lt;/myqueue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-LVQ"></a>14.9.4. LVQ</h3></div></div></div><p> To define a LVQ, add a <code class="varname">lvq</code> element with the value
+            <code class="constant">true</code>. Without any further configuration this will define an LVQ
+          which uses the JMS message property <code class="constant">qpid.LVQ_key</code> as the key for
+          replacement. </p><div class="example"><a name="idp8062016"></a><p class="title"><b>Example 14.11. Configuring a LVQ queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+    &lt;name&gt;myqueue&lt;/name&gt;
+    &lt;myqueue&gt;
+        &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+        &lt;lvq&gt;true&lt;/lvq&gt;
+    &lt;/myqueue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"><p> If you wish to define your own property then you can do so using the
+            <code class="varname">lvqKey</code> element.</p><div class="example"><a name="idp8064320"></a><p class="title"><b>Example 14.12. Configuring a LVQ queue with custom message property name</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+    &lt;name&gt;myqueue&lt;/name&gt;
+    &lt;myqueue&gt;
+        &lt;exchange&gt;amq.direct&lt;/exchange&gt;
+        &lt;lvq&gt;true&lt;/lvq&gt;
+        &lt;lvqKey&gt;ISIN&lt;/lvqKey&gt;
+    &lt;/myqueue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Virtual-Host-Configuring-Queue-With-Arguments"></a>14.9.5. Configuring queue with arguments</h3></div></div></div><p>Queue arguments can be configured in virtual host configuration file.
+        An element <span class="emphasis"><em>argument</em></span> is used to specify a queue argument as a name-value pair separated with equal character.
+        Any number of queue arguments can be provided for a queue in their own <span class="emphasis"><em>argument</em></span> elements.</p><p>The following example demonstrates how to configure queue with two arguments.</p><div class="example"><a name="idp8069136"></a><p class="title"><b>Example 14.13. Setting arbitrary queue arguments</b></p><div class="example-contents"><pre class="programlisting">
+&lt;queue&gt;
+    &lt;name&gt;myQueue&lt;/name&gt;
+    &lt;myQueue&gt;
+        &lt;argument&gt;qpid.group_header_key=JMSXgroupID&lt;/argument&gt;
+        &lt;argument&gt;qpid.shared_msg_group=1&lt;/argument&gt;
+    &lt;/myQueue&gt;
+&lt;/queue&gt;</pre></div></div><br class="example-break"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Virtual-Host-Configuration-Exchange.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Virtual-Hosts-Configuration-File.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Virtual-Host-Binding-Queue.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">14.8. Configuring Exchanges </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.10. Queue Binding</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html (added)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1,19 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>14.13. Configuring Transaction Timeouts</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Virtual-Hosts-Configuration-File.html" title="Chapter 14. Virtual Host XML configuration file"><link rel="prev" href="Java-Broker-Virtual-Host-Configure-Disk-Quotas.html" title="14.12. Configuring of Disk Quota-based Flow Control"><link rel="next" href="Java-Broker-Virtual-Host-Configuring-DLQ.html" title="14.14. Configuring DLQs/Maximum Delivery Count"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_b
 ox_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A><
 /LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><D
 IV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html">Virtual Host XML configuration file</a></span> &gt; <span class="breadcrumb-node">Configuring Transaction Timeouts</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Virtual-Host-Transaction-Timeout-Configuring"></a>14.13. Con
 figuring Transaction Timeouts</h2></div></div></div><p> The JMS transaction timeouts are configured on each virtual host defined in the XML
+    configuration files.</p><p> The default values for each of the parameters is 0, indicating that the particular check
+    is disabled.</p><p> Any or all of the parameters can be set, using the desired value in milliseconds, and will
+    be checked each time the housekeeping process runs, usually set to run every 30 seconds in
+    standard configuration. The meaning of each property is as follows:</p><p>
+    </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>openWarn - the time a transaction can be open for (with activity occurring on it) after
+       which a warning alert will be issued.</p></li><li class="listitem"><p>openClose - the time a transaction can be open for before the connection it is on is
+       closed.</p></li><li class="listitem"><p>idleWarn - the time a transaction can be idle for (with no activity occurring on it)
+       after which a warning alert will be issued.</p></li><li class="listitem"><p>idleClose - the time a transaction can be idle for before the connection it is on is
+       closed.</p></li></ul></div><p>
+   </p><p> The virtualhosts configuration is shown below, and must occur inside the
+   //virtualhosts/virtualhost/name/ elements: </p><div class="example"><a name="idp7916528"></a><p class="title"><b>Example 14.18. Configuring producer transaction timeout</b></p><div class="example-contents"><pre class="programlisting">
+&lt;transactionTimeout&gt;
+    &lt;openWarn&gt;10000&lt;/openWarn&gt;
+    &lt;openClose&gt;20000&lt;/openClose&gt;
+    &lt;idleWarn&gt;5000&lt;/idleWarn&gt;
+    &lt;idleClose&gt;15000&lt;/idleClose&gt;
+&lt;/transactionTimeout&gt;
+   </pre></div></div><br class="example-break"></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Virtual-Host-Configure-Disk-Quotas.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Virtual-Hosts-Configuration-File.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Virtual-Host-Configuring-DLQ.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">14.12. Configuring of Disk Quota-based Flow Control </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.14. Configuring DLQs/Maximum Delivery Count</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File-ACL.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File-ACL.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File-ACL.html (added)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File-ACL.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1,18 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>14.2. Configuring ACL</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Virtual-Hosts-Configuration-File.html" title="Chapter 14. Virtual Host XML configuration file"><link rel="prev" href="Java-Broker-Virtual-Hosts-Configuration-File.html" title="Chapter 14. Virtual Host XML configuration file"><link rel="next" href="Java-Broker-Stores-Memory-Store-Configuration.html" title="14.3. Configuring MemoryMessageStore"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="
 menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qp
 id.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></
 DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html">Virtual Host XML configuration file</a></span> &gt; <span class="breadcrumb-node">Configuring ACL</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Virtual-Hosts-Configuration-File-ACL"></a>14.2. Configuring ACL</h2></div></div></div><p><a class="xref
 " href="Java-Broker-Security-ACLs.html" title="11.3. Access Control Lists">Section 11.3, “Access Control Lists”</a> provides the details of ACL, rules, formats, etc.</p><p>
+        To apply an ACL on a single virtualhost named <em class="replaceable"><code>test</code></em>, add the following to the virtualhosts.xml:
+        </p><pre class="programlisting">
+&lt;virtualhost&gt;
+...
+    &lt;name&gt;test&lt;/name&gt;
+    &lt;test&gt;
+      ...
+      &lt;security&gt;                          <a name="Java-Broker-Virtual-Hosts-Configuration-Security-ACL-1"></a>(1)
+        ...
+        &lt;acl&gt;<em class="replaceable"><code>${conf}/vhost_test.acl</code></em>&lt;/acl&gt; <a name="Java-Broker-Virtual-Hosts-Configuration-Security-ACL-2"></a>(2)
+        ...
+      &lt;/security&gt;
+      ...
+    &lt;/test&gt;
+&lt;/virtualhost&gt;
+        </pre><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><a href="#Java-Broker-Virtual-Hosts-Configuration-Security-ACL-1">(1)</a> </p></td><td valign="top" align="left"><p>A security section of configuration is used to declare the ACL</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#Java-Broker-Virtual-Hosts-Configuration-Security-ACL-2">(2)</a> </p></td><td valign="top" align="left"><p>A path to an ACL file is configured (assuming that <em class="replaceable"><code>conf</code></em> has been set to a suitable
+      location such as ${QPID_HOME}/etc)</p></td></tr></table></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Virtual-Hosts-Configuration-File.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Virtual-Hosts-Configuration-File.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-Memory-Store-Configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 14. Virtual Host XML configuration file </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.3. Configuring MemoryMessageStore</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File.html (added)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts-Configuration-File.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1,11 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 14. Virtual Host XML configuration file</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-High-Availability-Performance.html" title="13.16. Performance"><link rel="next" href="Java-Broker-Virtual-Hosts-Configuration-File-ACL.html" title="14.2. Configuring ACL"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.h
 tml">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http:
 //qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.ap
 ache.org">Home</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-node">Virtual Host XML configuration file</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Virtual-Hosts-Configuration-File"></a>Chapter 14. Virtual Host XML configuration file</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Hosts-Configuration-File-In
 troduction">14.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File-ACL.html">14.2. Configuring ACL</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-Memory-Store-Configuration.html">14.3. Configuring MemoryMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store-Configuration.html">14.4. Configuring BDBMessageStore</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store-Configuration.html#Java-Broker-Stores-BDB-Store-Configuration_BDBEnvVars">14.4.1. Passing BDB environment configuration options</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-BDBHA-Store-Configuration.html">14.5. Configuring BDBHAMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-Derby-Store-Configuration.html">14.6. Configuring DerbyMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores
 -JDBC-Store-Configuration.html">14.7. Configuring JDBCMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configuration-Exchange.html">14.8. Configuring Exchanges</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html">14.9. Configuring Queues</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-Simple">14.9.1. Simple</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-Priority">14.9.2. Priority</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-Sorted">14.9.3. Sorted</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-LVQ">14.9.4. LVQ</a></sp
 an></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Virtual-Host-Configuring-Queue-With-Arguments">14.9.5. Configuring queue with arguments</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Virtual-Host-Binding-Queue.html">14.10. Queue Binding</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configure-Flow-Control.html">14.11. Configuring of Producer Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configure-Disk-Quotas.html">14.12. Configuring of Disk Quota-based Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html">14.13. Configuring Transaction Timeouts</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configuring-DLQ.html">14.14. Configuring DLQs/Maximum Delivery Count</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configur
 ation-File-Example.html">14.15. An example of virtual host configuration file</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Virtual-Hosts-Configuration-File-Introduction"></a>14.1. Introduction</h2></div></div></div><p>
+        This chapter describes how to configure Virtual Hosts using an XML file.
+    </p><p>
+        This is no longer the preferred approach for
+        <a class="link" href="Java-Broker-Virtual-Hosts.html#Java-Broker-Virtual-Hosts-Configuring-Managing" title="7.1. Configuring And Managing">defining a VirtualHost</a> and will likely be removed
+        in a future release, however it is currently neccessary to support certain use cases such as per-virtualhost attribute
+        configuration, and specialised store configuration such as for the <a class="link" href="Java-Broker-Stores-HA-BDB-Store.html" title="10.5. High Availability BDB Message Store">BDB HA Message Store</a>
+    </p><p>
+        Each XML Virtual Host configuration file can hold configuration for a single Virtual Host or multiple Virtual Hosts.
+        For an example file (with multiple VirtualHosts), see <a class="xref" href="Java-Broker-Virtual-Host-Configuration-File-Example.html" title="14.15. An example of virtual host configuration file">Section 14.15, “An example of virtual host configuration file”</a>
+    </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-High-Availability-Performance.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Virtual-Hosts-Configuration-File-ACL.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">13.16. Performance </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.2. Configuring ACL</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Virtual-Hosts.html Tue Oct  8 22:56:26 2013
@@ -1 +1,21 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 5. Virtual Hosts</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Concepts-Other-Services.html" title="4.7. Other Services"><link rel="next" href="Java-Broker-Exchanges.html" title="Chapter 6. Exchanges"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org
 /download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</
 A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache
 .org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-node">Virtual Hosts</span></DIV><div class="chapter" title="Chapter 5. Virtual Hosts"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Virtual-Hosts"></a>Chapter 5. Virtual Hosts</h2></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Concepts-Other-Services.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right">Â
  <a accesskey="n" href="Java-Broker-Exchanges.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.7. Other Services </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 6. Exchanges</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 7. Virtual Hosts</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Ports.html" title="Chapter 6. Broker Ports"><link rel="next" href="Java-Broker-Exchanges.html" title="Chapter 8. Exchanges"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.h
 tml">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI>
 <A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/founda
 tion/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-node">Virtual Hosts</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Virtual-Hosts"></a>Chapter 7. Virtual Hosts</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="Java-Broker-Virtual-Hosts.html#Java-Broker-Virtual-Hosts-Configuring-Managing">7.1. Configuring And Managing</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Brok
 er-Virtual-Hosts-Configuring-Managing"></a>7.1. Configuring And Managing</h2></div></div></div><p>
+        One or more Virtual Hosts can be configured on the Broker. The
+        <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-HTTP-Management-Introduction" title="5.2.1. Introduction">HTTP management interfaces</a>
+        can be used to add and delete Virtual Hosts.
+      </p><p>A new Virtual Host can be created in two ways:
+        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+                    <span class="emphasis"><em>Supplying simply a <a class="link" href="Java-Broker-Stores.html" title="Chapter 10. Virtual Host Message Stores">store type</a> and a store path</em></span>: In this case,
+                    the virtual host attributes are currently derived from default attribute values defined on the broker. This is the preferred approach.
+                </p></li><li class="listitem"><p>
+                    <span class="emphasis"><em>Supplying the path to a <a class="link" href="Java-Broker-Virtual-Hosts-Configuration-File.html" title="Chapter 14. Virtual Host XML configuration file">Virtual Host XML configuration file</a></em></span>: In this case, specific per-virtualhost attribute configuration
+                    can be set in the file, as well as pre-configuring queues, exchanges, etc. This is no longer the preferred approach and will likely be removed in
+                    a future release, however it is currently still neccessary to support certain use-cases such as per-virtualhost attribute configuration, and
+                    specialised store configuration such as for the <a class="link" href="Java-Broker-Stores-HA-BDB-Store.html" title="10.5. High Availability BDB Message Store">BDB HA Message Store</a>.
+                </p></li></ul></div><p>
+      </p><p>The following Virtual Host Managing operations are available from
+        <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.2. Web Management Console">Web Management Console</a>:
+        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>A new Virtual Host can be added into Broker by pressing "Add Virtual Host" button
+            on the Broker tab.</p></li><li class="listitem"><p>The existing Virtual Host(s) can be removed by pressing "Remove Virtual Host" button on the Broker tab.</p></li><li class="listitem"><p>The Virtual Host details can be viewed on the Virtual Host tab.
+            This tab can be displayed after clicking onto Virtual Host Name in the Broker object tree
+            or onto the Virtual Host row in the Virtual Hosts grid on the Broker tab.</p></li><li class="listitem"><p>Queues can be configured (added/removed) from Virtual Host tab</p></li><li class="listitem"><p>Exchange can be configured (added/removed) from Virtual Host tab</p></li><li class="listitem"><p>Existing Exchange/Queue tabs can be navigated from Virtual Host tab</p></li></ul></div><p>
+      </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Ports.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Exchanges.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. Broker Ports </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 8. Exchanges</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/components/java-broker/book/images/Broker-Model.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Broker-Model.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Broker-Model.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/Exchange-Direct.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Exchange-Direct.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Exchange-Direct.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/Exchange-Fanout.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Exchange-Fanout.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Exchange-Fanout.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/Exchange-Topic-Hierarchical.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Exchange-Topic-Hierarchical.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Exchange-Topic-Hierarchical.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/Exchange-Topic-JMSSelector.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Exchange-Topic-JMSSelector.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Exchange-Topic-JMSSelector.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/Exchange-Topic.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Exchange-Topic.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Exchange-Topic.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/Management-Web-Console.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/Management-Web-Console.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/Management-Web-Console.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/components/java-broker/book/images/VirtualHost-Model.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/images/VirtualHost-Model.png?rev=1530457&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/components/java-broker/book/images/VirtualHost-Model.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org