activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1043576 - /activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/
Date Wed, 08 Dec 2010 18:28:20 GMT
Author: chirino
Date: Wed Dec  8 18:28:20 2010
New Revision: 1043576

updated getting started so that folks use bdb store


Modified: activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/
--- activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/
+++ activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/
Wed Dec  8 18:28:20 2010
@@ -44,6 +44,18 @@ jar -xvf apache-apollo-${project_version
 4. Add the extracted `apache-apollo-${project_version}/bin` directory
    to your shell's `PATH` environment variable.
+## Install the BDB library
+Apollo's most stable message store implementation is the BDB based message store.  
+Unfortunately, BDB cannot be redistributed by Apache.  It is highly recommended
+that you add it to your apollo installation. You can download it from Oracle at
+[je-4.1.6.jar]( and
+then copy it into the `${APOLLO_HOME}/lib` directory.
+For those of you with curl installed, you can just run:
+    curl > ${APOLLO_HOME}/lib/je-4.1.6.jar
 ## Creating a Broker Instance
 A broker instance is the directory containing all the configuration and runtime
@@ -68,6 +80,14 @@ A broker instance directory will contain
 At this point you may want to adjust the default configuration located in
 etc directory.
+## Updating the Configuration to use BDB
+The default configuration used a hawtdb based store.  It still has known
+bugs and not yet stable.  Unless you want to help find and squash those bugs,
+it is recommend you change the configuration to use the BDB store instead.  To do that,
+just update the generated configuration by editing the `etc/apollo.xml` file and then
+replace `hawtdb-store` with `bdb-store`
 ## Running a Broker Instance
 Assuming you created the broker instance under `/var/lib/mybroker` all you need

View raw message