activemq-commits mailing list archives

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

URL: http://svn.apache.org/viewvc?rev=1043576&view=rev
Log:
updated getting started so that folks use bdb store

Modified:
    activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/getting-started.md

Modified: activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/getting-started.md
URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/getting-started.md?rev=1043576&r1=1043575&r2=1043576&view=diff
==============================================================================
--- activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/getting-started.md
(original)
+++ activemq/activemq-apollo/trunk/apollo-website/src/main/webapp/documentation/getting-started.md
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](http://download.oracle.com/maven/com/sleepycat/je/4.1.6/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 http://download.oracle.com/maven/com/sleepycat/je/4.1.6/je-4.1.6.jar > ${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



Mime
View raw message