Menu Search

8.4. BDB Store

The Java broker has an optional 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.

8.4.1. Oracle BDB JE download

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.

If you wish to use the BDBMessageStore, then you must download the Oracle BDB JE 5.0.58 release from the Oracle website.

The download has a name in the form je-5.0.58.tar.gz. It is recommended that you confirm the integrity of the download by verifying the MD5.

8.4.2. Oracle BDB JE jar installation

If you wish to use the BDBMessageStore, copy the je-5.0.58.jar from within the release downloaded above into the 'opt' sub-directory of the brokers 'lib' directory.

cp je-5.0.58.jar qpid-broker-0.20/lib/opt
copy je-5.0.58.jar qpid-broker-0.20\lib\opt

8.4.3. Configuration

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.

Example 8.3. Configuring a VirtualHost to use the BDBMessageStore