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 [27/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/

Modified: qpid/site/input/components/java-broker/book/Java-Broker-Security.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Security.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Security.html (original)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Security.html Tue Oct  8 22:56:26 2013
@@ -1,9 +1,137 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 10. Security</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-Configuring-And-Managing-Other-Tooling.html" title="9.5. Other Tooling"><link rel="next" href="Java-Broker-Security-Group-Providers.html" title="10.2. Configuring Group Providers"></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">Security</span></DIV><div class="chapter" title="Chapter 10. Security"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Security"></a>Chapter 10. Security</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Users-And-Groups">10.1. Users And Groups</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-Group-Provi
 ders.html">10.2. Configuring Group Providers</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-Group-Providers.html#File-Group-Manager">10.2.1. FileGroupManager</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.html">10.3. Authentication Providers</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.html#idp666320">10.3.1. Password File</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.html#LDAPAuthManager">10.3.2. LDAP</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.html#idp687008">10.3.3. Kerberos</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.html#ExternalAuthManager">10.3.4. External (SSL Client Certificates)</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.h
 tml#AnonymousAuthManager">10.3.5. Anonymous</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-Authentication-Providers.html#MultipleAuthProviders">10.3.6. Configuring multiple Authentication Providers</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-ACLs.html">10.4. Access Control Lists</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-EnablingACL">10.4.1. 
-       Enabling ACLs
-    </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-WriteACL">10.4.2. 
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 11. Security</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-Stores-HA-BDB-Store.html" title="10.5. High Availability BDB Message Store"><link rel="next" href="Java-Broker-Security-Group-Providers.html" title="11.2. Group Providers"></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 h
 ref="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">Security</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Security"></a>Chapter 11. Security</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-Security.html#Java-Broker-Security-Authentication-Providers">11.1. Authentication Providers</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-S
 ecurity-LDAP-Provider">11.1.1. Simple LDAP Authentication Provider</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Kerberos-Provider">11.1.2. Kerberos</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-External-Provider">11.1.3. External (SSL Client Certificates)</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Anonymous-Provider">11.1.4. Anonymous</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-PlainPasswordFile-Provider">11.1.5. Plain Password File</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Base64MD5PasswordFile-Provider">11.1.6. Base64MD5 Password File</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-Group-Providers.html">11.2. Group Providers</a></span></dt><dd><dl><dt><span class="section"><a href="Java-B
 roker-Security-Group-Providers.html#File-Group-Manager">11.2.1. GroupFile Provider</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-ACLs.html">11.3. Access Control Lists</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-WriteACL">11.3.1. 
        Writing .acl files
-    </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-Syntax">10.4.3. 
+    </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-Syntax">11.3.2. 
        Syntax
-    </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-WorkedExamples">10.4.4. 
+    </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-WorkedExamples">11.3.3. 
       Worked Examples
-    </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-SSL.html">10.5. SSL</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-SSL.html#SSL-Keystore">10.5.1. Keystore Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-SSL.html#SSL-Truststore-ClientCertificate">10.5.2. Truststore / Client Certificate Authentication</a></span></dt></dl></dd></dl></div><div class="section" title="10.1. Users And Groups"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Security-Users-And-Groups"></a>10.1. Users And Groups</h2></div></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-Configuring-And-Managing-Other-Tooling.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Security-Group-
 Providers.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">9.5. Other Tooling </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 10.2. Configuring Group Providers</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+    </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-SSL.html">11.4. SSL</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-SSL.html#Java-Broker-SSL-Keystore">11.4.1. Keystore Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-SSL.html#SSL-Truststore-ClientCertificate">11.4.2. Truststore / Client Certificate Authentication</a></span></dt></dl></dd></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Security-Authentication-Providers"></a>11.1. Authentication Providers</h2></div></div></div><p>
+    In order to successfully establish a connection to the Java Broker, the connection must be
+    authenticated. The Java Broker supports a number of different authentication schemes, each
+    with its own "authentication provider". Any number of Authentication Providers can be configured
+    on the Broker at the same time.
+  </p><p>
+    The Authentication Providers can be configured using <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.4. REST API">REST Management interfaces</a>
+             and <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><p>The following Authentication Provider managing operations are available from Web Management Console:
+    </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>A new Authentication Provider can be added by clicking onto "Add Provider" on the Broker tab.</p></li><li class="listitem"><p>An Authentication Provider details can be viewed on the Authentication Provider tab.
+        The tab is displayed after clicking onto Authentication Provider name in the Broker object tree or after clicking
+        onto Authentication Provider row in Authentication Providers grid on the Broker tab.</p></li><li class="listitem"><p>Editing of Authentication Provider can be performed by clicking on "Edit" button
+        on Authentication Provider tab.</p></li><li class="listitem"><p>An existing  Authentication Provider can be deleted by clicking on "Delete Provider" button
+        on Broker tab or "Delete" button on the Authentication Provider tab.</p></li></ul></div><p>
+    The Authentication Provider type and name cannot be changed for existing providers as editing of name and type
+    is unsupported at the moment. Only provider specific attributes can be modified in the editing dialog
+    and stored in the broker configuration store.
+  </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3>
+  Only unused Authentication Provider can be deleted. For delete requests attempting to delete Authentication Provider
+  associated with the Ports, the errors will be returned and delete operations will be aborted. It is possible to change
+  the Authentication Provider on Port at runtime. However, the Broker restart is required for changes on Port to take effect.
+  </div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Security-LDAP-Provider"></a>11.1.1. Simple LDAP Authentication Provider</h3></div></div></div><p>
+    SimpleLDAPAuthenticationProvider authenticate the connections by searching for a user unique distinguished name
+    in the pre-configured LDAP search directory and performing LDAP bind using the found DN and password after that.
+    On creation of SimpleLDAPAuthenticationProvider the following mandatory fields are required to specify:
+    </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>LDAP server URL</em></span> is an URL of LDAP server, for example, ldaps://example.com:636</p></li><li class="listitem"><p><span class="emphasis"><em>Search context</em></span> is a LDAP directory name to search for users entries, for example, "dc=users,dc=example,dc=com"</p></li><li class="listitem"><p><span class="emphasis"><em>Search filter</em></span> is a DN template to find an LDAP user entry by provided user name, for example, (uid={0})</p></li></ul></div><p>
+    Additionally, the following optional fields can be specified:
+    </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>LDAP context factory</em></span> is fully qualified class name for the JNDI LDAP context factory.</p></li><li class="listitem"><p><span class="emphasis"><em>LDAP authentication URL</em></span>is an URL of LDAP server for performing "ldap bind"
+            if a different LDAP URL is required for performing an authentication.</p></li></ul></div><p>
+  </p><p>
+    <span class="emphasis"><em>NOTE: When using LDAP authentication, you must also use SSL on the brokers AMQP messaging and
+    JMX/HTTP management ports in order to protect passwords during transmission to the broker.</em></span>
+  </p><p>
+    The Authentication Provider first connects to the ldap server anonymously and searches for the
+    ldap entity which is identified by the username provided over SASL. Essentially the
+    authentication manager calls DirContext.search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)
+    with the values of <span class="emphasis"><em>Search context</em></span> and <span class="emphasis"><em>Search filter</em></span> as the first two arguments,
+    and the username as the only element in the array which is the third argument.
+  </p><p>
+    If the search returns a name from the LDAP server, the Authentication Provider then attempts to
+    login to the LDAP server with the given name and the password.
+  </p><p>
+    If the URL to open for authentication is different to that for the search, then the
+    authentication url can be overridden using &lt;LDAP authentication URL&gt; in addition to providing a
+    &lt;LDAP server URL&gt;. Note that the URL used for authentication should use ldaps:// since
+    passwords will be being sent over it.
+  </p><p>
+    By default com.sun.jndi.ldap.LdapCtxFactory is used to create the context, however this can be
+    overridden by specifying &lt;LDAP context factory&gt; in the configuration.
+  </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Security-Kerberos-Provider"></a>11.1.2. Kerberos</h3></div></div></div><p>
+    Kereberos Authentication Provider uses java GSS-API SASL mechanism to authenticate the connections.
+  </p><p>
+    Configuration of kerberos is done through system properties (there doesn't seem to be a way
+    around this unfortunately).
+  </p><pre class="programlisting">
+    export JAVA_OPTS=-Djavax.security.auth.useSubjectCredsOnly=false -Djava.security.auth.login.config=qpid.conf
+    ${QPID_HOME}/bin/qpid-server
+  </pre><p>Where qpid.conf would look something like this:</p><pre class="programlisting">
+com.sun.security.jgss.accept {
+    com.sun.security.auth.module.Krb5LoginModule required
+    useKeyTab=true
+    storeKey=true
+    doNotPrompt=true
+    realm="EXAMPLE.COM"
+    useSubjectCredsOnly=false
+    kdc="kerberos.example.com"
+    keyTab="/path/to/keytab-file"
+    principal="&lt;name&gt;/&lt;host&gt;";
+};</pre><p>
+    Where realm, kdc, keyTab and principal should obviously be set correctly for the environment
+    where you are running (see the existing documentation for the C++ broker about creating a keytab
+    file).
+  </p><p>
+    Note: You may need to install the "Java Cryptography Extension (JCE) Unlimited Strength
+    Jurisdiction Policy Files" appropriate for your JDK in order to get Kerberos support working.
+  </p><p>
+    Since Kerberos support only works where SASL authentication is available (e.g. not for JMX
+    authentication) you may wish to also include an alternative Authentication Provider
+    configuration, and use this for JMX and HTTP ports.
+  </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Security-External-Provider"></a>11.1.3. External (SSL Client Certificates)</h3></div></div></div><p>
+      When <a class="link" href="Java-Broker-Security-SSL.html#SSL-Truststore-ClientCertificate" title="11.4.2. Truststore / Client Certificate Authentication"> requiring SSL Client Certificates</a> be
+      presented the External Authentication Provider can be used, such that the user is authenticated based on
+      trust of their certificate alone, and the X500Principal from the SSL session is then used as the username
+      for the connection, instead of also requiring the user to present a valid username and password.
+    </p><p>
+      <span class="bold"><strong>Note:</strong></span> The External Authentication Provider should typically only be used on the
+      AMQP ports, in conjunction with <a class="link" href="Java-Broker-Security-SSL.html#SSL-Truststore-ClientCertificate" title="11.4.2. Truststore / Client Certificate Authentication">SSL client certificate
+      authentication</a>. It is not intended for other uses such as the JMX management port and will treat any
+      non-sasl authentication processes on these ports as successful with the given username. As such you should
+      configure another Authentication Provider for use on non-AMQP ports. Perhaps the only exception to this
+      would be where the broker is embedded in a container that is itself externally protecting the HTTP interface
+      and then providing the remote users name.
+    </p><p>On creation of External Provider the use of full DN or username CN as a principal name can be configured.
+    If field "Use the full DN as the Username" is set to "true" the full DN is used as an authenticated principal name.
+    If field "Use the full DN as the Username" is set to "false" the user name CN part is used as the authenticated principal name.
+    Setting the field to "false" is particular useful when <a class="link" href="Java-Broker-Security-ACLs.html" title="11.3. Access Control Lists">ACL</a> is required,
+    as at the moment, ACL does not support commas in the user name.
+    </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Security-Anonymous-Provider"></a>11.1.4. Anonymous</h3></div></div></div><p>
+      The Anonymous Authentication Provider will allow users to connect with or without credentials and result
+      in their identification on the broker as the user ANONYMOUS. This Provider does not require specification
+      of any additional fields on creation.
+    </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Security-PlainPasswordFile-Provider"></a>11.1.5. Plain Password File</h3></div></div></div><p>
+      The PlainPasswordFile Provider uses local file to store and manage user credentials.
+      When creating an authentication provider the path to the file needs to be specified.
+      If specified file does not exist an empty file is created automatically on Authentication Provider creation.
+      On  Provider deletion the password file is deleted as well. For this Provider
+      user credentials can be added, removed or changed using REST management interfaces and web management console.
+    </p><p>
+    On navigating to the Plain Password File Provider tab (by clicking onto provider name from Broker tree or provider
+    row in providers grid on Broker tab) the list of existing credentials is displayed on the tab with the buttons "Add User"
+    and "Delete Users" to add new user credentials and delete the existing user credentials respectively.
+    On clicking into user name on Users grid the pop-up dialog to change the password is displayed.
+    </p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="idp7548672"></a>11.1.5.1. Plain Password File Format</h4></div></div></div><p>
+            The user credentials are stored on the single file line as user name and user password pairs separated by colon character.
+        </p><pre class="programlisting">
+# password file format
+# &lt;user name&gt;: &lt;user password&gt;
+guest:guest
+        </pre></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Security-Base64MD5PasswordFile-Provider"></a>11.1.6. Base64MD5 Password File</h3></div></div></div><p>
+      Base64MD5PasswordFile Provider uses local file to store and manage user credentials similar to Similar to PlainPasswordFile
+      but instead of storing a password the MD5 password digest encoded with Base64 encoding is stored in the file.
+      When creating an authentication provider the path to the file needs to be specified.
+      If specified file does not exist an empty file is created automatically on Authentication Provider creation.
+      On Base64MD5PasswordFile Provider deletion the password file is deleted as well. For this Provider
+      user credentials can be added, removed or changed using REST management interfaces and web management console.
+    </p><p>
+    On navigating to the Base64MD5PasswordFile Provider tab (by clicking onto provider name from Broker tree or provider
+    row in providers grid on Broker tab) the list of existing credentials is displayed on the tab with the buttons "Add User"
+    and "Delete Users" to add new user credentials and delete the existing user credentials respectively.
+    On clicking into user name on Users grid the pop-up dialog to change the password is displayed.
+    </p></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-Stores-HA-BDB-Store.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Security-Group-Providers.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">10.5. High Availability BDB Message Store </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 11.2. Group Providers</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store-Configuration.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store-Configuration.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store-Configuration.html (added)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store-Configuration.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1,32 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>14.4. Configuring BDBMessageStore</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-Stores-Memory-Store-Configuration.html" title="14.3. Configuring MemoryMessageStore"><link rel="next" href="Java-Broker-Stores-BDBHA-Store-Configuration.html" title="14.5. Configuring BDBHAMessageStore"></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="men
 u_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-link"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html">Virtual Host XML configuration file</a></span> &gt; <span class="breadcrumb-node">Configuring BDBMessageStore</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-BDB-Store-Configuration"></a>14.4. Configuring BDBMessageStore</h2></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="idp8022080"></a><p class="title"><b>Example 14.2. Configuring a VirtualHost to use the BDBMessageStore</b></p><div class="example-contents"><pre class="programlisting">
+&lt;virtualhosts&gt;
+  &lt;virtualhost&gt;
+    &lt;name&gt;vhostname&lt;/name&gt;
+    &lt;vhostname&gt;
+      &lt;store&gt;
+        &lt;class&gt;org.apache.qpid.server.store.berkeleydb.BDBMessageStore&lt;/class&gt;
+        &lt;environment-path&gt;${QPID_WORK}/bdbstore/vhostname&lt;/environment-path&gt;
+      &lt;/store&gt;
+      ...
+    &lt;/vhostname&gt;
+  &lt;/virtualhost&gt;
+&lt;/virtualhosts&gt;
+    </pre></div></div><br class="example-break"><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-Configuration_BDBEnvVars"></a>14.4.1. Passing BDB environment configuration options</h3></div></div></div><p>It is possible to pass BDB <a class="ulink" href="http://docs.oracle.com/cd/E17277_02/html/java/com/sleepycat/je/EnvironmentConfig.html" target="_top">
+	     environment</a> from the virtualhost.xml. Environment configuration options are passed using
+	     <code class="varname">envConfig</code> elements within the <code class="varname">store</code> element.</p><p>For example, to override the BDB environment configuration options <code class="varname">je.cleaner.threads</code> and
+	    <code class="varname">je.log.fileMax</code></p><div class="example"><a name="idp8027888"></a><p class="title"><b>Example 14.3. Configuring BDB Environment Configuration</b></p><div class="example-contents"><pre class="programlisting">
+      &lt;store&gt;
+	...
+	&lt;envConfig&gt;
+	  &lt;name&gt;je.cleaner.threads&lt;/name&gt;
+	  &lt;value&gt;2&lt;/value&gt;
+	&lt;/envConfig&gt;
+	&lt;envConfig&gt;
+	  &lt;name&gt;je.log.fileMax&lt;/name&gt;
+	  &lt;value&gt;5000000&lt;/value&gt;
+	&lt;/envConfig&gt;
+	  ...
+      &lt;/store&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-Stores-Memory-Store-Configuration.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-BDBHA-Store-Configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">14.3. Configuring MemoryMessageStore </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.5. Configuring BDBHAMessageStore</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Modified: qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store.html (original)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDB-Store.html Tue Oct  8 22:56:26 2013
@@ -1,36 +1,28 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>8.4. BDB Store</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="Java-Broker-Stores.html" title="Chapter 8. Stores"><link rel="prev" href="Java-Broker-Stores-SQL-Store.html" title="8.3. SQL Store"><link rel="next" href="Java-Broker-Stores-HA-BDB-Store.html" title="8.5. High Availability BDB 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.o
 rg/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.apac
 he.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-Stores.html">Stores</a></span> &gt; <span class="breadcrumb-node">BDB Store</span></DIV><div class="section" title="8.4. BDB Store"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-BDB-Store"></a>8.4. BDB Store</h2></div></div></div><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>10.4. BDB Message Store</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-Stores.html" title="Chapter 10. Virtual Host Message Stores"><link rel="prev" href="Java-Broker-Stores-SQL-Store.html" title="10.3. SQL Message Store"><link rel="next" href="Java-Broker-Stores-HA-BDB-Store.html" title="10.5. High Availability BDB 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.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.apac
 he.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-Stores.html">Virtual Host Message Stores</a></span> &gt; <span class="breadcrumb-node">BDB Message Store</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-BDB-Store"></a>10.4. BDB Message Store</h2></div></div></div><p>
     The Java broker has an <span class="emphasis"><em>optional</em></span> message store implementation backed by Oracle BDB JE.
     This section will detail where to download the optional dependency from, how to add it to the broker installation,
     and provide an example configuration for using the BDBMessageStore.
-  </p><div class="section" title="8.4.1. Oracle BDB JE download"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-BDBJE-Download"></a>8.4.1. Oracle BDB JE download</h3></div></div></div><p>
+  </p><p>
+    The BDBMessageStore can be selected on Virtual Host creation
+    via <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.4. REST API">REST Management interfaces</a>
+    and <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>.
+    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 BDBMessageStore can configured in Virtual Host configuration xml.
+    For details, see <a class="xref" href="Java-Broker-Stores-BDB-Store-Configuration.html" title="14.4. Configuring BDBMessageStore">Section 14.4, “Configuring BDBMessageStore”</a>.
+  </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-BDBJE-Download"></a>10.4.1. Oracle BDB JE download</h3></div></div></div><p>
       The BDB based message store is optional due to its dependency on Oracle BDB JE, which is distributed under the Sleepycat
       licence. As a result of this, the dependency cant be distributed by the Apache Qpid project as part of the broker release package.
     </p><p>
-       If you wish to use the BDBMessageStore, then you must download the Oracle BDB JE 5.0.58 release
+       If you wish to use the BDBMessageStore, then you must download the Oracle BDB JE 5.0.84 release
       <a class="ulink" href="http://www.oracle.com/technetwork/products/berkeleydb/downloads/index.html?ssSourceSiteId=ocomen" target="_top">from the Oracle website.</a>
     </p><p>
-      The download has a name in the form je-5.0.58.tar.gz. It is recommended that you
+      The download has a name in the form je-5.0.84.tar.gz. It is recommended that you
       confirm the integrity of the download by verifying the MD5.
-    </p></div><div class="section" title="8.4.2. Oracle BDB JE jar installation"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-BDBJE-Installation"></a>8.4.2. Oracle BDB JE jar installation</h3></div></div></div><p>
-      If you wish to use the BDBMessageStore, copy the je-5.0.58.jar from within the release
-      downloaded <a class="link" href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download" title="8.4.1. Oracle BDB JE download">above</a> into the 'opt' sub-directory
+    </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-BDBJE-Installation"></a>10.4.2. Oracle BDB JE jar installation</h3></div></div></div><p>
+      If you wish to use the BDBMessageStore, copy the je-5.0.84.jar from within the release
+      downloaded <a class="link" href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download" title="10.4.1. Oracle BDB JE download">above</a> into the 'opt' sub-directory
       of the brokers 'lib' directory.
     </p><pre class="programlisting">Unix:
-cp je-5.0.58.jar qpid-broker-0.21/lib/opt</pre><pre class="programlisting">Windows:
-copy je-5.0.58.jar qpid-broker-0.21\lib\opt</pre></div><div class="section" title="8.4.3. Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-BDB-Store-Configuration"></a>8.4.3. Configuration</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="idp195616"></a><p class="title"><b>Example 8.3. Configuring a VirtualHost to use the BDBMessageStore</b></p><div class="example-contents"><pre class="programlisting">
-&lt;virtualhosts&gt;
-  &lt;virtualhost&gt;
-    &lt;name&gt;vhostname&lt;/name&gt;
-    &lt;vhostname&gt;
-      &lt;store&gt;
-        &lt;class&gt;org.apache.qpid.server.store.berkeleydb.BDBMessageStore&lt;/class&gt;
-        &lt;environment-path&gt;${QPID_WORK}/bdbstore/vhostname&lt;/environment-path&gt;
-      &lt;/store&gt;
-      ...
-    &lt;/vhostname&gt;
-  &lt;/virtualhost&gt;
-&lt;/virtualhosts&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-Stores-SQL-Store.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Stores.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-HA-BDB-Store.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8.3. SQL Store </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 8.5. High Availability BDB Store</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+cp je-5.0.84.jar qpid-broker-0.25/lib/opt</pre><pre class="programlisting">Windows:
+copy je-5.0.84.jar qpid-broker-0.25\lib\opt</pre></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-Stores-SQL-Store.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Stores.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-HA-BDB-Store.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">10.3. SQL Message Store </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 10.5. High Availability BDB Message Store</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDBHA-Store-Configuration.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDBHA-Store-Configuration.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDBHA-Store-Configuration.html (added)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Stores-BDBHA-Store-Configuration.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>14.5. Configuring BDBHAMessageStore</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-Stores-BDB-Store-Configuration.html" title="14.4. Configuring BDBMessageStore"><link rel="next" href="Java-Broker-Stores-Derby-Store-Configuration.html" title="14.6. Configuring DerbyMessageStore"></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_bo
 x_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.apac
 he.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><DI
 V 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 BDBHAMessageStore</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-BDBHA-Store-Configuration"></a>14.5. Configuring BDBHAMessageStore</h2></div></div></div>
 <p>See <a class="xref" href="Java-Broker-High-Availability-Configuration.html" title="13.5. Configuring a Virtual Host to be a node">Section 13.5, “Configuring a Virtual Host to be a node”</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Stores-BDB-Store-Configuration.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-Derby-Store-Configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">14.4. Configuring BDBMessageStore </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.6. Configuring DerbyMessageStore</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></
 body></html>

Added: qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store-Configuration.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store-Configuration.html?rev=1530457&view=auto
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store-Configuration.html (added)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store-Configuration.html Tue Oct  8 22:56:26 2013
@@ -0,0 +1,17 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>14.6. Configuring DerbyMessageStore</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-Stores-BDBHA-Store-Configuration.html" title="14.5. Configuring BDBHAMessageStore"><link rel="next" href="Java-Broker-Stores-JDBC-Store-Configuration.html" title="14.7. Configuring JDBCMessageStore"></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.ap
 ache.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 DerbyMessageStore</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-Derby-Store-Configuration"></a>14.6. Configuring DerbyMessageStore</h2></div></div></di
 v><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="idp8033712"></a><p class="title"><b>Example 14.4. Configuring a VirtualHost to use the DerbyMessageStore</b></p><div class="example-contents"><pre class="programlisting">
+&lt;virtualhosts&gt;
+  &lt;virtualhost&gt;
+    &lt;name&gt;vhostname&lt;/name&gt;
+    &lt;vhostname&gt;
+      &lt;store&gt;
+        &lt;class&gt;org.apache.qpid.server.store.DerbyMessageStore&lt;/class&gt;
+        &lt;environment-path&gt;${QPID_WORK}/derbystore/vhostname&lt;/environment-path&gt;
+      &lt;/store&gt;
+      ...
+    &lt;/vhostname&gt;
+  &lt;/virtualhost&gt;
+&lt;/virtualhosts&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-Stores-BDBHA-Store-Configuration.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-JDBC-Store-Configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">14.5. Configuring BDBHAMessageStore </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 14.7. Configuring JDBCMessageStore</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Modified: qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store.html (original)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Stores-Derby-Store.html Tue Oct  8 22:56:26 2013
@@ -1,20 +1,12 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>8.2. Derby Store</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="Java-Broker-Stores.html" title="Chapter 8. Stores"><link rel="prev" href="Java-Broker-Stores.html" title="Chapter 8. Stores"><link rel="next" href="Java-Broker-Stores-SQL-Store.html" title="8.3. SQL 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">Downl
 oad</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="h
 ttps://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/spons
 orship.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-Stores.html">Stores</a></span> &gt; <span class="breadcrumb-node">Derby Store</span></DIV><div class="section" title="8.2. Derby Store"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-Derby-Store"></a>8.2. Derby Store</h2></div></div></div><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>10.2. Derby Message Store</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-Stores.html" title="Chapter 10. Virtual Host Message Stores"><link rel="prev" href="Java-Broker-Stores.html" title="Chapter 10. Virtual Host Message Stores"><link rel="next" href="Java-Broker-Stores-SQL-Store.html" title="10.3. SQL 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.apach
 e.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">Ho
 me</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-Stores.html">Virtual Host Message Stores</a></span> &gt; <span class="breadcrumb-node">Derby Message Store</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-Derby-Store"></a>10.2. Derby Message Store</h2></div></div></div><p>
     The Java broker has a message store implementation backed by Apache Derby.
     This section will detail configuration for using the DerbyMessageStore.
-  </p><div class="section" title="8.2.1. Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-Derby-Store-Configuration"></a>8.2.1. Configuration</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="idp335056"></a><p class="title"><b>Example 8.2. Configuring a VirtualHost to use the DerbyMessageStore</b></p><div class="example-contents"><pre class="programlisting">
-&lt;virtualhosts&gt;
-  &lt;virtualhost&gt;
-    &lt;name&gt;vhostname&lt;/name&gt;
-    &lt;vhostname&gt;
-      &lt;store&gt;
-        &lt;class&gt;org.apache.qpid.server.store.DerbyMessageStore&lt;/class&gt;
-        &lt;environment-path&gt;${QPID_WORK}/derbystore/vhostname&lt;/environment-path&gt;
-      &lt;/store&gt;
-      ...
-    &lt;/vhostname&gt;
-  &lt;/virtualhost&gt;
-&lt;/virtualhosts&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-Stores.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Stores.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-SQL-Store.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 8. Stores </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 8.3. SQL Store</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+  </p><p>
+    The DerbyMessageStore can be selected on Virtual Host creation
+    via <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.4. REST API">REST Management interfaces</a>
+    and <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>.
+    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 DerbyMessageStore can configured in Virtual Host configuration xml.
+    For details, see <a class="xref" href="Java-Broker-Stores-Derby-Store-Configuration.html" title="14.6. Configuring DerbyMessageStore">Section 14.6, “Configuring DerbyMessageStore”</a>.
+  </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Stores.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Stores.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Stores-SQL-Store.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 10. Virtual Host Message Stores </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 10.3. SQL Message Store</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Modified: qpid/site/input/components/java-broker/book/Java-Broker-Stores-HA-BDB-Store.html
URL: http://svn.apache.org/viewvc/qpid/site/input/components/java-broker/book/Java-Broker-Stores-HA-BDB-Store.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/input/components/java-broker/book/Java-Broker-Stores-HA-BDB-Store.html (original)
+++ qpid/site/input/components/java-broker/book/Java-Broker-Stores-HA-BDB-Store.html Tue Oct  8 22:56:26 2013
@@ -1,19 +1,20 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>8.5. High Availability BDB Store</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="Java-Broker-Stores.html" title="Chapter 8. Stores"><link rel="prev" href="Java-Broker-Stores-BDB-Store.html" title="8.4. BDB Store"><link rel="next" href="Java-Broker-Configuring-And-Managing.html" title="Chapter 9. Configuring And Managing"></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/mail
 ing_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-Stores.html">Stores</a></span> &gt; <span class="breadcrumb-node">High Availability BDB Store</span></DIV><div class="section" title="8.5. High Availability BDB Store"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-HA-BDB-Store"></a>8.5. High Availability BDB Store</h2></div></div></div><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>10.5. High Availability BDB Message Store</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-Stores.html" title="Chapter 10. Virtual Host Message Stores"><link rel="prev" href="Java-Broker-Stores-BDB-Store.html" title="10.4. BDB Message Store"><link rel="next" href="Java-Broker-Security.html" title="Chapter 11. Security"></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">Hom
 e</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-Stores.html">Virtual Host Message Stores</a></span> &gt; <span class="breadcrumb-node">High Availability BDB Message Store</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Stores-HA-BDB-Store"></a>10.5. High Availability BDB Message Store</h2></div></div></div><p>
     The Java broker has an <span class="emphasis"><em>optional</em></span> High Availability message store implementation backed by Oracle BDB JE HA.
     This section references information on where to download the optional dependency from, how to add it to the broker
     installation, and how to configure the BDBHAMessageStore.
   </p><p>
-    For more detailed information about use of this store, see <a class="xref" href="Java-Broker-High-Availability.html" title="Chapter 12. High Availability">Chapter 12, <i>High Availability</i></a>.
-  </p><div class="section" title="8.5.1. Oracle BDB JE download"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-HA-BDB-Store-BDBJE-Download"></a>8.5.1. Oracle BDB JE download</h3></div></div></div><p>
-      For details, see <a class="xref" href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download" title="8.4.1. Oracle BDB JE download">Section 8.4.1, “Oracle BDB JE download”</a>.
-    </p></div><div class="section" title="8.5.2. Oracle BDB JE jar installation"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-HA-BDB-Store-BDBJE-Installation"></a>8.5.2. Oracle BDB JE jar installation</h3></div></div></div><p>
-      For details, see <a class="xref" href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Installation" title="8.4.2. Oracle BDB JE jar installation">Section 8.4.2, “Oracle BDB JE jar installation”</a>.
-    </p></div><div class="section" title="8.5.3. Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-HA-BDB-Store-Configuration"></a>8.5.3. Configuration</h3></div></div></div><p>
-      In order to use the BDBHAMessageStore, you must configure it for each VirtualHost desired by updating the store element
+    For more detailed information about use of this store, see <a class="xref" href="Java-Broker-High-Availability.html" title="Chapter 13. High Availability">Chapter 13, <i>High Availability</i></a>.
+  </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-HA-BDB-Store-BDBJE-Download"></a>10.5.1. Oracle BDB JE download</h3></div></div></div><p>
+      For details, see <a class="xref" href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download" title="10.4.1. Oracle BDB JE download">Section 10.4.1, “Oracle BDB JE download”</a>.
+    </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-HA-BDB-Store-BDBJE-Installation"></a>10.5.2. Oracle BDB JE jar installation</h3></div></div></div><p>
+      For details, see <a class="xref" href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Installation" title="10.4.2. Oracle BDB JE jar installation">Section 10.4.2, “Oracle BDB JE jar installation”</a>.
+    </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Stores-HA-BDB-Store-Configuration"></a>10.5.3. Configuration</h3></div></div></div><p>
+      In order to use the BDBHAMessageStore, you must use 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>
+        when <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>, configuring it for each VirtualHost desired by updating the store element
       to specify the associated store class, provide a directory location for the data to be written, and configure the
       replication group and policies used by BDB JA HA.
     </p><p>
-      A general configuration example is shown <a class="link" href="Java-Broker-High-Availability-Configuration.html" title="12.5. Configuring a Virtual Host to be a node">here</a>, however it
-      is strongly recommended you examine the wider context of <a class="xref" href="Java-Broker-High-Availability.html" title="Chapter 12. High Availability">Chapter 12, <i>High Availability</i></a> for a fuller
+      A general configuration example is shown <a class="link" href="Java-Broker-High-Availability-Configuration.html" title="13.5. Configuring a Virtual Host to be a node">here</a>, however it
+      is strongly recommended you examine the wider context of <a class="xref" href="Java-Broker-High-Availability.html" title="Chapter 13. High Availability">Chapter 13, <i>High Availability</i></a> for a fuller
       discussion of the various configuration options and how to use them.
-    </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-Stores-BDB-Store.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Stores.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Configuring-And-Managing.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8.4. BDB Store </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 9. Configuring And Managing</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+    </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-Stores-BDB-Store.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Stores.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Security.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">10.4. BDB Message Store </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 11. Security</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>



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