svn commit: r1295160 - in /activemq/activemq-apollo/trunk/apollo-website/src: blog/releases/release-1.1.page documentation/index.page documentation/migration-guide.md documentation/user-manual.md index.page

[ch...@apache.org]

Author: chirino
Date: Wed Feb 29 15:41:33 2012
New Revision: 1295160

URL: http://svn.apache.org/viewvc?rev=1295160&view=rev
Log:
Add a migration guide to help folks migrate from 1.0 -> 1.1

Added:
    activemq/activemq-apollo/trunk/apollo-website/src/documentation/migration-guide.md
Modified:
    activemq/activemq-apollo/trunk/apollo-website/src/blog/releases/release-1.1.page
    activemq/activemq-apollo/trunk/apollo-website/src/documentation/index.page
    activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md
    activemq/activemq-apollo/trunk/apollo-website/src/index.page

Modified: activemq/activemq-apollo/trunk/apollo-website/src/blog/releases/release-1.1.page
URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/blog/releases/release-1.1.page?rev=1295160&r1=1295159&r2=1295160&view=diff
==============================================================================
--- activemq/activemq-apollo/trunk/apollo-website/src/blog/releases/release-1.1.page (original)
+++ activemq/activemq-apollo/trunk/apollo-website/src/blog/releases/release-1.1.page Wed Feb 29 15:41:33 2012
@@ -31,6 +31,10 @@ new features like:
  * [APLO-145] - Support WebSockets
  * [APLO-152] - Support an option to have topics retain the last message sent to it
 
+This version introduces a change to the LevelDB store's file format so make sure you follow
+the [Migration Guide](${website_base_url}/versions/1.1/website/documentation/migration-guide.html)
+if your upgradig from 1.0.
+
 For further information see:
 
 * [Download](${website_base_url}/download.html)

Modified: activemq/activemq-apollo/trunk/apollo-website/src/documentation/index.page
URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/documentation/index.page?rev=1295160&r1=1295159&r2=1295160&view=diff
==============================================================================
--- activemq/activemq-apollo/trunk/apollo-website/src/documentation/index.page (original)
+++ activemq/activemq-apollo/trunk/apollo-website/src/documentation/index.page Wed Feb 29 15:41:33 2012
@@ -25,6 +25,7 @@ ${project_slogan}
 
 * [Getting Started Guide](getting-started.html)
 * [User Manual](user-manual.html)
+* [Migration Guide](migration-guide.html)
 * [Management API](management-api.html)
 * [Contributor Documentation](../community/developers.html)
 * [Extending Guide](extending-guide.html)

Added: activemq/activemq-apollo/trunk/apollo-website/src/documentation/migration-guide.md
URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/documentation/migration-guide.md?rev=1295160&view=auto
==============================================================================
--- activemq/activemq-apollo/trunk/apollo-website/src/documentation/migration-guide.md (added)
+++ activemq/activemq-apollo/trunk/apollo-website/src/documentation/migration-guide.md Wed Feb 29 15:41:33 2012
@@ -0,0 +1,47 @@
+# Version Migration Guide
+
+## Overview
+
+This guide helps you migrate to a new Apollo version and perserve
+the message data stored in the previous version of the Apollo broker.
+This guide assumes you are only using a single virtual host in your 
+configuration.
+
+## Standard Migration Steps
+
+You should first check to see if a "data export/import" is required 
+by consulting the [Migration Notes](#Migration_Notes) section
+at the end of this docuemnt.
+
+1. Stop your broker instance.
+
+2. If a data export/import is required then export your 
+   broker instance data to an archive file by running:
+
+		${broker-path}/bin/apollo-broker store-export /tmp/broker-export.tgz
+    
+   Then move your old data directory out of the way by running:
+
+         mv ${broker-path}/data /tmp/broker-data
+
+4. Install your new apollo version.  Since Apollo packages include the version
+   in thier insallation directroy you should be able to unpack it to same
+   directory your previous vesion was unpack into.
+
+5. Switch yout broker instance to use the new Apollo version by editing
+   the `${broker-path}/bin/apollo-broker` script and changing the line 
+   that sets the `APOLLO_HOME=` variable.  Set it to the location of
+   where the new version is installed.
+
+6. If a data export/import is required then import your 
+   broker instance data from the archive by running:
+
+
+		${broker-path}/bin/apollo-broker store-import /tmp/broker-export.tgz
+
+
+6. Start your broker.
+
+## Migration Notes 
+
+*  **1.0 -> 1.1** : A data export/import is required if your using a LevelDB store.

Modified: activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md
URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md?rev=1295160&r1=1295159&r2=1295160&view=diff
==============================================================================
--- activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md (original)
+++ activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md Wed Feb 29 15:41:33 2012
@@ -435,10 +435,13 @@ implementations currently supported are:
 
 * [LevelDB Store](#LevelDB_Store) : is a file based message store implemented using the 
   [Google's LevelDB](http://en.wikipedia.org/wiki/LevelDB) library to maintain indexes into 
-  log files holding the messages.
+  log files holding the messages.  This the default implementation used.  It uses a JNI
+  driver on Linux and OS X, but falls back to a pure Java version on other 
+  platforms (but this is tested less).
 * [BDB Store](#BDB_Store) : is a file based message store implemented using the 
   [Sleepycat BDB](http://en.wikipedia.org/wiki/Berkeley_DB) library.
-  This is the most stable implementation.
+  This implemenation should work equally well on all platforms since it's a pure
+  java implementation.
 
 ###### LevelDB Store
 

Modified: activemq/activemq-apollo/trunk/apollo-website/src/index.page
URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/index.page?rev=1295160&r1=1295159&r2=1295160&view=diff
==============================================================================
--- activemq/activemq-apollo/trunk/apollo-website/src/index.page (original)
+++ activemq/activemq-apollo/trunk/apollo-website/src/index.page Wed Feb 29 15:41:33 2012
@@ -57,5 +57,6 @@ ActiveMQ 5.x JMS clients.
 
  * [Getting Started Guide](documentation/getting-started.html)
  * [User Manual](documentation/user-manual.html)
+ * [Migration Guide](documentation/migration-guide.html)