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
