You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by or...@apache.org on 2013/05/09 18:12:30 UTC
svn commit: r1480714 [12/13] - in
/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book: html/
html/images/ pdf/
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Stores.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Stores.html?rev=1480714&r1=1480713&r2=1480714&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Stores.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Stores.html Thu May 9 16:12:28 2013
@@ -1,23 +1,16 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 8. Stores</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-Queues-OtherTypes.html" title="7.2. Other Queue Types"><link rel="next" href="Java-Broker-Stores-Derby-Store.html" title="8.2. Derby Store"></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="h
ttp://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> > <span class="breadcrumb-node">Stores</span></DIV><div class="chapter" title="Chapter 8. Stores"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores"></a>Chapter 8. Stores</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-Broker-Stores.html#Java-Broker-Stores-Memory-Store">8.1. Memory Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores.html#Java-Broker-Stores-Memory-Store-Co
nfiguration">8.1.1. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-Derby-Store.html">8.2. Derby Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-Derby-Store.html#Java-Broker-Stores-Derby-Store-Configuration">8.2.1. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-SQL-Store.html">8.3. SQL Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html">8.4. BDB Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download">8.4.1. Oracle BDB JE download</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Installation">8.4.2. Oracle BDB JE jar installation</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-Configuration">8.4.
3. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html">8.5. High Availability BDB Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-BDBJE-Download">8.5.1. Oracle BDB JE download</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-BDBJE-Installation">8.5.2. Oracle BDB JE jar installation</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-Configuration">8.5.3. Configuration</a></span></dt></dl></dd></dl></div><div class="section" title="8.1. Memory Store"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-Memory-Store"></a>8.1. Memory Store</h2></div></div></div><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 10. Virtual Host Message Stores</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-Queues.html" title="Chapter 9. Queues"><link rel="next" href="Java-Broker-Stores-Derby-Store.html" title="10.2. Derby Message Store"></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_l
ists.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> > <span class="breadcrumb-node">Virtual Host Message Stores</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Stores"></a>Chapter 10. Virtual Host Message Stores</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-Stores.html#Java-Broker-Stores-Memory-Store">10.1. Memory Message Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Stor
es-Derby-Store.html">10.2. Derby Message Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-SQL-Store.html">10.3. SQL Message Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-SQL-Store.html#Java-Broker-Stores-JDBC-Store-Driver">10.3.1. JDBC driver</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html">10.4. BDB Message Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download">10.4.1. Oracle BDB JE download</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Installation">10.4.2. Oracle BDB JE jar installation</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html">10.5. High Availability BDB Message Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-
Store.html#Java-Broker-Stores-HA-BDB-Store-BDBJE-Download">10.5.1. Oracle BDB JE download</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-BDBJE-Installation">10.5.2. Oracle BDB JE jar installation</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-Configuration">10.5.3. Configuration</a></span></dt></dl></dd></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-Memory-Store"></a>10.1. Memory Message Store</h2></div></div></div><p>
The Java broker has an in-memory message store implementation.
This section will detail configuration for using the MemoryMessageStore.
</p><p>
Note: when using this store, the broker will store both persistent and non-persistent messages
in memory, which is to say that neither will be available following a broker restart, and the
ability to store new messages will be entirely constrained by the JVM heap size.
- </p><div class="section" title="8.1.1. Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-Memory-Store-Configuration"></a>8.1.1. Configuration</h3></div></div></div><p>
- In order to use the MemoryMessageStore, you must configure it for each VirtualHost desired by updating the store element
- to specify the associated store class, as shown below.
- </p><div class="example"><a name="idp345248"></a><p class="title"><b>Example 8.1. Configuring a VirtualHost to use the MemoryMessageStore</b></p><div class="example-contents"><pre class="programlisting">
-<virtualhosts>
- <virtualhost>
- <name>vhostname</name>
- <vhostname>
- <store>
- <class>org.apache.qpid.server.store.MemoryMessageStore</class
- </store>
- ...
- </vhostname>
- </virtualhost>
-</virtualhosts>
-</pre></div></div><br class="example-break"></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-Queues-OtherTypes.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-Derby-Store.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">7.2. Other Queue Types </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 8.2. Derby Store</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+ </p><p>
+ The MemoryMessageStore can be selected on Virtual Host creation
+ via <a class="link" href="Java-Broker-Configuring-And-Managing-Web-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.2. REST API">REST Management interfaces</a>
+ and <a class="link" href="Java-Broker-Configuring-And-Managing-Web-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.1. Web Console">Web Management Console</a>.
+ For details, see <a class="xref" href="Java-Broker-Virtual-Hosts.html" title="Chapter 7. Virtual Hosts">Chapter 7, <i>Virtual Hosts</i></a>.
+ </p><p>
+ Alternatively, the MemoryMessageStore can configured in Virtual Host configuration xml.
+ For details, see <a class="xref" href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Stores-Memory-Store-Configuration" title="7.2.2. Configuring MemoryMessageStore">Section 7.2.2, âConfiguring MemoryMessageStoreâ</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-Queues.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-Derby-Store.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 9. Queues </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 10.2. Derby Message Store</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Added: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts-Configuration-File.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts-Configuration-File.html?rev=1480714&view=auto
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts-Configuration-File.html (added)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts-Configuration-File.html Thu May 9 16:12:28 2013
@@ -0,0 +1,429 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>7.2. Configuring Virtual Host using 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="Java-Broker-Virtual-Hosts.html" title="Chapter 7. Virtual Hosts"><link rel="prev" href="Java-Broker-Virtual-Hosts.html" title="Chapter 7. Virtual Hosts"><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.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 h
ref="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 h
ref="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> > <span class="breadcrumb-link"><a href="Java-Broker-Virtual-Hosts.html">Virtual Hosts</a></span> > <span class="breadcrumb-node">Configuring Virtual Host using configuration file</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Virtual-Hosts-Configuration-File"></a>7.2. Configuring Virtual Host using configuration file</h2></div></div></div><p>This section describes how to configure Virtual
Host using configuration XML.</p><p>Virtual Host configuration XML can hold configuration for a single Virtual Host or multiple Virtual Hosts.
+ When multiple Virtual Hosts are configured a section for the each virtual host needs to be added. It should contain a tag
+ having the same name as virtual host.
+ </p><pre class="programlisting">
+<virtualhosts>
+ ...
+ <virtualhost> <a name="Java-Broker-Virtual-Hosts-Configuration-Multiple-1"></a>(1)
+ <name>test</name>
+ <test>
+ ...
+ </test>
+ </virtualhost>
+
+ <virtualhost> <a name="Java-Broker-Virtual-Hosts-Configuration-Multiple-2"></a>(2)
+ <name>development</name>
+ <development>
+ ...
+ </development>
+ </virtualhost>
+ ...
+</virtualhosts>
+ </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-Multiple-1">(1)</a> </p></td><td valign="top" align="left"><p>A configuration section for a virtual host "test"</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#Java-Broker-Virtual-Hosts-Configuration-Multiple-2">(2)</a> </p></td><td valign="top" align="left"><p>A configuration section for a virtual host "development"</p></td></tr></table></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Virtual-Hosts-Configuration-File-ACL"></a>7.2.1. Configuring ACL</h3></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 config.xml:
+ </p><pre class="programlisting">
+<virtualhost>
+...
+ <name>test</name>
+ <test>
+ ...
+ <security> <a name="Java-Broker-Virtual-Hosts-Configuration-Security-ACL-1"></a>(1)
+ ...
+ <acl><em class="replaceable"><code>${conf}/vhost_test.acl</code></em></acl> <a name="Java-Broker-Virtual-Hosts-Configuration-Security-ACL-2"></a>(2)
+ ...
+ </security>
+ ...
+ </test>
+</virtualhost>
+ </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 class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-Memory-Store-Configuration"></a>7.2.2. Configuring MemoryMessageStore</h3></div></div></div><p>
+ An example of MemoryMessageStore configuration for a virtual host is shown below:
+ </p><div class="example"><a name="id1195454"></a><p class="title"><b>Example 7.1. Configuring a VirtualHost to use the MemoryMessageStore</b></p><div class="example-contents"><pre class="programlisting">
+<virtualhosts>
+ <virtualhost>
+ <name>vhostname</name>
+ <vhostname>
+ <store>
+ <class>org.apache.qpid.server.store.MemoryMessageStore</class
+ </store>
+ ...
+ </vhostname>
+ </virtualhost>
+</virtualhosts>
+ </pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-Configuration"></a>7.2.3. Configuring BDBMessageStore</h3></div></div></div><p>
+ In order to use the BDBMessageStore, you must configure it for each VirtualHost desired by updating the store element
+ to specify the associated store class and provide a directory location for the data to be written, as shown below.
+ </p><div class="example"><a name="id1196224"></a><p class="title"><b>Example 7.2. Configuring a VirtualHost to use the BDBMessageStore</b></p><div class="example-contents"><pre class="programlisting">
+<virtualhosts>
+ <virtualhost>
+ <name>vhostname</name>
+ <vhostname>
+ <store>
+ <class>org.apache.qpid.server.store.berkeleydb.BDBMessageStore</class>
+ <environment-path>${QPID_WORK}/bdbstore/vhostname</environment-path>
+ </store>
+ ...
+ </vhostname>
+ </virtualhost>
+</virtualhosts>
+ </pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-Derby-Store-Configuration"></a>7.2.4. Configuring DerbyMessageStore</h3></div></div></div><p>
+ In order to use the DerbyMessageStore, you must configure it for each VirtualHost desired by updating the store element
+ to specify the associated store class and provide a directory location for the data to be written, as shown below.
+ </p><div class="example"><a name="id1195135"></a><p class="title"><b>Example 7.3. Configuring a VirtualHost to use the DerbyMessageStore</b></p><div class="example-contents"><pre class="programlisting">
+<virtualhosts>
+ <virtualhost>
+ <name>vhostname</name>
+ <vhostname>
+ <store>
+ <class>org.apache.qpid.server.store.DerbyMessageStore</class>
+ <environment-path>${QPID_WORK}/derbystore/vhostname</environment-path>
+ </store>
+ ...
+ </vhostname>
+ </virtualhost>
+</virtualhosts>
+ </pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-JDBC-Store-Configuration"></a>7.2.5. Configuring JDBCMessageStore</h3></div></div></div><p>
+ JDBCMessageStore can be configured on VirtualHost as in example shown below:
+ </p><div class="example"><a name="id1195165"></a><p class="title"><b>Example 7.4. Configuring a VirtualHost to use the JDBCMessageStore</b></p><div class="example-contents"><pre class="programlisting">
+<virtualhosts>
+ <virtualhost>
+ <name>vhostname</name>
+ <vhostname>
+ <store>
+ <class>org.apache.qpid.server.store.jdbc.JDBCMessageStore</class>
+ <connectionUrl>jdbc:oracle:thin:guest@guest//localhost:1521/orcl</connectionUrl>
+ </store>
+ ...
+ </vhostname>
+ </virtualhost>
+</virtualhosts>
+</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-Configuration-Exchange"></a>7.2.6. Configuring Exchanges</h3></div></div></div><p>
+ To declare Exchanges within Virtual Host configuration, add the appropriate xml
+ to the virtualhost.xml configuration file within the <code class="varname">exchanges</code> element.
+ An example of such declaration is shown below:
+ </p><div class="example"><a name="id1193888"></a><p class="title"><b>Example 7.5. Configuring Exchanges on VirtualHost</b></p><div class="example-contents"><pre class="programlisting">
+<virtualhosts>
+ <virtualhost>
+ <name>vhostname</name>
+ ...
+ <exchanges>
+ <exchange>
+ <type>direct</type>
+ <name>test.direct</name>
+ <durable>true</durable>
+ </exchange>
+ <exchange>
+ <type>topic</type>
+ <name>test.topic</name>
+ </exchange>
+ </exchanges>
+ ...
+ </vhostname>
+ </virtualhost>
+</virtualhosts>
+</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-Declare-Queues"></a>7.2.7. Configuring Queues</h3></div></div></div><p>To create a priority, sorted or LVQ queue within configuration, 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><h4 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Simple"></a>7.2.7.1. Simple</h4></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="id1195404"></a><p class="title"><b>Example 7.6. Configuring a simple queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <name>my-simple-queue</name>
+ <my-simple-queue>
+ <exchange>amq.direct</exchange>
+ <durable>true</durable>
+ </my-simple-queue>
+</queue></pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Priority"></a>7.2.7.2. Priority</h4></div></div></div><p> To defining a priority queue, add a <priority>true</priority> element. By
+ default the queue will have 10 distinct priorities. </p><div class="example"><a name="id1194185"></a><p class="title"><b>Example 7.7. Configuring a priority queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <name>myqueue</name>
+ <myqueue>
+ <exchange>amq.direct</exchange>
+ <priority>true</priority>
+ </myqueue>
+</queue></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="id1194207"></a><p class="title"><b>Example 7.8. Configuring a priority queue with fewer priorities</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <name>myqueue</name>
+ <myqueue>
+ <exchange>amq.direct</exchange>
+ <priority>true</priority>
+ <priorities>4</priorities>
+ </myqueue>
+</queue></pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Sorted"></a>7.2.7.3. Sorted</h4></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="id1194244"></a><p class="title"><b>Example 7.9. Configuring a sorted queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <name>myqueue</name>
+ <myqueue>
+ <exchange>amq.direct</exchange>
+ <sortKey>message-property-to-sort-by</sortKey>
+ </myqueue>
+</queue></pre></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-LVQ"></a>7.2.7.4. LVQ</h4></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="id1195602"></a><p class="title"><b>Example 7.10. Configuring a LVQ queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <name>myqueue</name>
+ <myqueue>
+ <exchange>amq.direct</exchange>
+ <lvq>true</lvq>
+ </myqueue>
+</queue></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="id1195621"></a><p class="title"><b>Example 7.11. Configuring a LVQ queue with custom message property name</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <name>myqueue</name>
+ <myqueue>
+ <exchange>amq.direct</exchange>
+ <lvq>true</lvq>
+ <lvqKey>ISIN</lvqKey>
+ </myqueue>
+</queue></pre></div></div><br class="example-break"></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Virtual-Host-Configure-Flow-Control"></a>7.2.8. Configuring of Producer Flow Control</h3></div></div></div><p>Flow control capacity and flow resume capacity are required to set on a queue or virtual host to enable Producer flow control.</p><div class="example"><a name="id1196254"></a><p class="title"><b>Example 7.12. Configuring a queue depth limit</b></p><div class="example-contents"><pre class="programlisting">
+
+<queue>
+ <name>test</name>
+ <test>
+ <exchange>amq.direct</exchange>
+
+ <!-- set the queue capacity to 10Mb -->
+ <capacity>10485760</capacity>
+
+ <!-- set the resume capacity to 8Mb -->
+ <flowResumeCapacity>8388608</flowResumeCapacity>
+ </test>
+</queue>
+
+ </pre></div></div><br class="example-break">
+
+ The default for all queues on a virtual host can also be set
+
+ <div class="example"><a name="id1196268"></a><p class="title"><b>Example 7.13. Configuring of default queue depth limit on virtualhost</b></p><div class="example-contents"><pre class="programlisting">
+
+<virtualhosts>
+ <virtualhost>
+ <name>localhost</name>
+ <localhost>
+
+ <!-- set the queue capacity to 10Mb -->
+ <capacity>10485760</capacity>
+
+ <!-- set the resume capacity to 8Mb -->
+ <flowResumeCapacity>8388608</flowResumeCapacity>
+ </localhost>
+ </virtualhost>
+</virtualhosts>
+
+ </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-Configure-Disk-Quotas"></a>7.2.9. Configuring of Disk Quota-based Flow Control</h3></div></div></div><p>
+ An example of quota configuration for the BDB message store is provided below.
+ </p><div class="example"><a name="id1196300"></a><p class="title"><b>Example 7.14. Configuring a limit on a store</b></p><div class="example-contents"><pre class="programlisting">
+
+<store>
+ <class>org.apache.qpid.server.store.berkeleydb.BDBMessageStore</class>
+ <environment-path>${work}/bdbstore/test</environment-path>
+ <overfull-size>50000000</overfull-size>
+ <underfull-size>45000000</underfull-size>
+</store>
+
+ </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-Transaction-Timeout-Configuring"></a>7.2.10. Configuring Transaction Timeouts</h3></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="id1197099"></a><p class="title"><b>Example 7.15. Configuring producer transaction timeout</b></p><div class="example-contents"><pre class="programlisting">
+<transactionTimeout>
+ <openWarn>10000</openWarn>
+ <openClose>20000</openClose>
+ <idleWarn>5000</idleWarn>
+ <idleClose>15000</idleClose>
+</transactionTimeout>
+ </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-DLQ"></a>7.2.11. Configuring DLQs/Maximum Delivery Count</h3></div></div></div><p>In the below configuration it can be seen that DLQs/Maximum Delivery Count are enabled at
+ the virtual host "localhost" with maximum delivery count set to 5 and disable for virtual host "dev-only".</p><p>As 'dev-only-main-queue' has its own configuration specified, this value overrides all
+ others and causes the features to be enabled for this queue. In contrast to this,
+ 'dev-only-other-queue' does not specify its own value and picks up the false value specified for
+ its parent virtualhost, causing the DLQ/Maximum Delivery Count features to be disabled for this
+ queue. Any such queue in the 'dev-only' virtualhost which does not specify its own configuration
+ value will have the DLQ/Maximum Delivery Count feature disabled.</p><p>The queue 'localhost-queue' has the DLQ/Maximum Delivery Count features disabled.
+ Any other queue in the 'localhost' virtualhost which does not specify
+ its own configuration value will have the features enabled (inherited from parent virtual host).</p><div class="example"><a name="id1197143"></a><p class="title"><b>Example 7.16. Enabling DLQs and maximum delivery count at virtualhost and queue level within
+ virtualhosts.xml</b></p><div class="example-contents"><pre class="programlisting"><virtualhosts>
+ ...
+ <virtualhost>
+ <name>dev-only</name>
+ <dev-only>
+ <queues>
+ <deadLetterQueues>false</deadLetterQueues>
+ <maximumDeliveryCount>0</maximumDeliveryCount>
+ <queue>
+ <name>dev-only-main-queue</name>
+ <dev-only-main-queue>
+ <deadLetterQueues>true</deadLetterQueues>
+ <maximumDeliveryCount>3</maximumDeliveryCount>
+ </dev-only-main-queue>
+ </queue>
+ <queue>
+ <name>dev-only-other-queue</name>
+ </queue>
+ </queues>
+ </dev-only>
+ </virtualhost>
+ <virtualhost>
+ <name>localhost</name>
+ <localhost>
+ <queues>
+ <deadLetterQueues>true</deadLetterQueues>
+ <maximumDeliveryCount>5</maximumDeliveryCount>
+ <queue>
+ <name>localhost-queue</name>
+ <deadLetterQueues>false</deadLetterQueues>
+ </queue>
+ </queues>
+ </localhost>
+ </virtualhost>
+ ...
+</virtualhosts>
+ </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-Configuration-Example"></a>7.2.12. An example of virtual host configuration file</h3></div></div></div><div class="example"><a name="id1197175"></a><p class="title"><b>Example 7.17. An example of virtual host configuration file</b></p><div class="example-contents"><pre class="programlisting">
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<virtualhosts>
+ <virtualhost>
+ <name>localhost</name>
+ <localhost>
+ <store>
+ <class>org.apache.qpid.server.store.MemoryMessageStore</class>
+ <!--<class>org.apache.qpid.server.store.derby.DerbyMessageStore</class>
+ <environment-path>${QPID_WORK}/derbystore</environment-path>-->
+ </store>
+
+ <housekeeping>
+ <threadCount>2</threadCount>
+ <checkPeriod>20000</checkPeriod>
+ </housekeeping>
+
+ <exchanges>
+ <exchange>
+ <type>direct</type>
+ <name>test.direct</name>
+ <durable>true</durable>
+ </exchange>
+ <exchange>
+ <type>topic</type>
+ <name>test.topic</name>
+ </exchange>
+ </exchanges>
+ <queues>
+ <exchange>amq.direct</exchange>
+ <maximumQueueDepth>4235264</maximumQueueDepth>
+ <!-- 4Mb -->
+ <maximumMessageSize>2117632</maximumMessageSize>
+ <!-- 2Mb -->
+ <maximumMessageAge>600000</maximumMessageAge>
+ <!-- 10 mins -->
+ <maximumMessageCount>50</maximumMessageCount>
+ <!-- 50 messages -->
+
+ <queue>
+ <name>queue</name>
+ </queue>
+ <queue>
+ <name>ping</name>
+ </queue>
+ <queue>
+ <name>test-queue</name>
+ <test-queue>
+ <exchange>test.direct</exchange>
+ <durable>true</durable>
+ </test-queue>
+ </queue>
+ <queue>
+ <name>test-ping</name>
+ <test-ping>
+ <exchange>test.direct</exchange>
+ </test-ping>
+ </queue>
+
+ </queues>
+ </localhost>
+ </virtualhost>
+
+ <virtualhost>
+ <name>development</name>
+ <development>
+ <store>
+ <class>org.apache.qpid.server.store.MemoryMessageStore</class>
+ <!--<class>org.apache.qpid.server.store.derby.DerbyMessageStore</class>
+ <environment-path>${QPID_WORK}/derbystore</environment-path>-->
+ </store>
+
+ <queues>
+ <minimumAlertRepeatGap>30000</minimumAlertRepeatGap>
+ <maximumMessageCount>50</maximumMessageCount>
+ <queue>
+ <name>queue</name>
+ <queue>
+ <exchange>amq.direct</exchange>
+ <maximumQueueDepth>4235264</maximumQueueDepth>
+ <!-- 4Mb -->
+ <maximumMessageSize>2117632</maximumMessageSize>
+ <!-- 2Mb -->
+ <maximumMessageAge>600000</maximumMessageAge>
+ <!-- 10 mins -->
+ </queue>
+ </queue>
+ <queue>
+ <name>ping</name>
+ <ping>
+ <exchange>amq.direct</exchange>
+ <maximumQueueDepth>4235264</maximumQueueDepth>
+ <!-- 4Mb -->
+ <maximumMessageSize>2117632</maximumMessageSize>
+ <!-- 2Mb -->
+ <maximumMessageAge>600000</maximumMessageAge>
+ <!-- 10 mins -->
+ </ping>
+ </queue>
+ </queues>
+ </development>
+ </virtualhost>
+
+ <virtualhost>
+ <name>test</name>
+ <test>
+ <store>
+ <!--<class>org.apache.qpid.server.store.MemoryMessageStore</class>-->
+ <class>org.apache.qpid.server.store.derby.DerbyMessageStore</class>
+ <environment-path>${QPID_WORK}/derbystore</environment-path>
+ </store>
+
+ <queues>
+ <minimumAlertRepeatGap>30000</minimumAlertRepeatGap>
+ <maximumMessageCount>50</maximumMessageCount>
+ <queue>
+ <name>queue</name>
+ <queue>
+ <exchange>amq.direct</exchange>
+ <maximumQueueDepth>4235264</maximumQueueDepth>
+ <!-- 4Mb -->
+ <maximumMessageSize>2117632</maximumMessageSize>
+ <!-- 2Mb -->
+ <maximumMessageAge>600000</maximumMessageAge>
+ <!-- 10 mins -->
+ </queue>
+ </queue>
+ <queue>
+ <name>ping</name>
+ <ping>
+ <exchange>amq.direct</exchange>
+ <maximumQueueDepth>4235264</maximumQueueDepth>
+ <!-- 4Mb -->
+ <maximumMessageSize>2117632</maximumMessageSize>
+ <!-- 2Mb -->
+ <maximumMessageAge>600000</maximumMessageAge>
+ <!-- 10 mins -->
+ </ping>
+ </queue>
+ </queues>
+ </test>
+ </virtualhost>
+</virtualhosts>
+ </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-Hosts.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Virtual-Hosts.html">Up</a></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 7. Virtual Hosts </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>
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts.html?rev=1480714&r1=1480713&r2=1480714&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Virtual-Hosts.html Thu May 9 16:12:28 2013
@@ -1 +1,19 @@
-<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.ap
ache.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> > <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-Virtual-Hosts-Configuration-File.html" title="7.2. Configuring Virtual Host using configuration file"></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.htm
l">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> > <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><dt><span class
="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html">7.2. Configuring Virtual Host using configuration file</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Hosts-Configuration-File-ACL">7.2.1. Configuring ACL</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Stores-Memory-Store-Configuration">7.2.2. Configuring MemoryMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Stores-BDB-Store-Configuration">7.2.3. Configuring BDBMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Stores-Derby-Store-Configuration">7.2.4. Configuring DerbyMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Stores-JDBC-Store-Confi
guration">7.2.5. Configuring JDBCMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Configuration-Exchange">7.2.6. Configuring Exchanges</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Declare-Queues">7.2.7. Configuring Queues</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Configure-Flow-Control">7.2.8. Configuring of Producer Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Configure-Disk-Quotas">7.2.9. Configuring of Disk Quota-based Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Transaction-Timeout-Configuring">7.2.10. Configuring Transaction Timeouts</a></s
pan></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Configuring-DLQ">7.2.11. Configuring DLQs/Maximum Delivery Count</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Host-Configuration-Example">7.2.12. An example of virtual host configuration file</a></span></dt></dl></dd></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-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-Web-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.2. REST API">REST Management interfaces</a>
+ and <a class="link" href="Java-Broker-Configuring-And-Managing-Web-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.1. Web Console">Web Management Console</a>
+ can be used to add and delete Virtual Hosts.</p><p>A new Virtual Host can be created in two ways by specifying either:
+ </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>A <a class="link" href="Java-Broker-Stores.html" title="Chapter 10. Virtual Host Message Stores">store type</a> and a store path</p></li><li class="listitem"><p>A path to Virtual Host XML configuration file</p></li></ul></div><p>
+ In first case the virtual host attributes are derived from Broker global attributes.
+ In the second case, the Virtual Host specific configuration can be set in the configuration XML,
+ for example, alert thresholds, message store, queues, exchanges, ACL etc. The first way of Virtual Host creation
+ is more preferable as it will reduce the burden of configuration changes when migrating to a newer version,
+ especially, when the support of Virtual Host configuration XML will be removed. However, the second way
+ is the only way at the moment to configure <a class="link" href="Java-Broker-Stores-HA-BDB-Store.html" title="10.5. High Availability BDB Message Store">HA Message Store</a>,
+ Virtual Host <a class="link" href="Java-Broker-Security-ACLs.html" title="11.3. Access Control Lists">ACL</a> and virtual host specific attributes.
+ </p><p>The following Virtual Host Managing operations are available from
+ <a class="link" href="Java-Broker-Configuring-And-Managing-Web-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.1. Web 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-Virtual-Hosts-Configuration-File.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"> 7.2. Configuring Virtual Host using configuration file</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Added: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/Broker-Model.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/Broker-Model.png?rev=1480714&view=auto
==============================================================================
Binary file - no diff available.
Propchange: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/Broker-Model.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/Management-Web-Console.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/Management-Web-Console.png?rev=1480714&view=auto
==============================================================================
Binary file - no diff available.
Propchange: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/Management-Web-Console.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/VirtualHost-Model.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/images/VirtualHost-Model.png?rev=1480714&view=auto
==============================================================================
Binary file - no diff available.
Propchange: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/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