[Checkins] SVN: gocept.zeoraid/trunk/ Add installation instructions for alpha testing.

[Christian Theune]

Log message for revision 84256:
  Add installation instructions for alpha testing.
  
  Add external to the correct ZODB branch.
  
  Minor buildout cleanup.
  
  

Changed:
  A   gocept.zeoraid/trunk/INSTALL.txt
  U   gocept.zeoraid/trunk/base.cfg
  A   gocept.zeoraid/trunk/externals/

-=-
Added: gocept.zeoraid/trunk/INSTALL.txt
===================================================================
--- gocept.zeoraid/trunk/INSTALL.txt	                        (rev 0)
+++ gocept.zeoraid/trunk/INSTALL.txt	2008-02-26 06:54:49 UTC (rev 84256)
@@ -0,0 +1,90 @@
+==================
+Installing ZEORaid
+==================
+
+Note: These are preliminary instructions for installing the test releases for
+ZEORaid. The actual deployment mechanisms are not yet in place and will be
+documented in this file in the future.
+
+
+Quick installation
+==================
+
+This installation procedure will install a ZEORaid server connected to 2 local ZEO
+servers.
+
+You can tweak the settings in `parts/*` to 
+
+1. Check out the ZEORaid code and buildout:
+
+  $ svn co svn://svn.zope.org/repos/main/gocept.zeoraid/tags/1.0a1 gocept.zeoraid
+
+2. Copy the `buildout.cfg.example` file to `buildout.cfg`:
+
+  $ cp buildout.cfg.example buildout.cfg
+
+3. Bootstrap and run the buildout with Python 2.4:
+
+  $ python2.4 bootstrap.py
+  $ bin/buildout
+
+4. Start the servers:
+
+  $ bin/server1 start
+  $ bin/server2 start
+  $ bin/zeoraid start
+
+Run the tests
+=============
+
+You might want to run the test suite to make sure that ZEORaid works as
+expected on your platform:
+
+  $ bin/test -vv --all
+
+If you see *any* test failures please report them as bugs.
+
+
+Reporting bugs
+==============
+
+The bug tracker lives at http://bugs.launchpad.net/gocept.zeoraid
+
+Please file bugs there and provide tracebacks.
+
+
+Customizing your configuration
+==============================
+
+The parts directory contains the configuration for ZEORaid and the two ZEO
+servers. Those appear like normal ZEO server configurations and can be tweaked
+by you to experiment with different settings.
+
+Note that those settings are overridden when re-running buildout.
+
+If you want to connect ZEORaid to existing ZEO servers, please remember:
+
+ - ZEORaid needs the `gocept-iteration` branch to run on both the ZEORaid
+   server and the backend ZEO servers. This branch will be merged to the trunk
+   after completion and review and should be available in the final ZODB 3.9
+   release.
+
+ - Keep backups of your data. ZEORaid has good unit test coverage but hasn't
+   seen live action yet, so keep this in mind.
+
+
+Accessing the management script
+===============================
+
+The management script is still a bit rough. Here's how you call it:
+
+  $ bin/client src/gocept/zeoraid/manage.py <command> [args]
+
+The available commands are:
+
+  details
+  status
+  disable [storage]
+  recover [storage]
+
+The script currently always expects ZEORaid to run on localhost:8100.


Property changes on: gocept.zeoraid/trunk/INSTALL.txt
___________________________________________________________________
Name: svn:eol-style
   + native

Modified: gocept.zeoraid/trunk/base.cfg
===================================================================
--- gocept.zeoraid/trunk/base.cfg	2008-02-26 06:53:15 UTC (rev 84255)
+++ gocept.zeoraid/trunk/base.cfg	2008-02-26 06:54:49 UTC (rev 84256)
@@ -1,5 +1,5 @@
 [buildout]
-develop = .
+develop = . externals/ZODB
 parts = zodbscripts test client server1 server2 zeoraid
 find-links = http://download.zope.org/distribution/
 
@@ -10,6 +10,9 @@
 
 # Some demo parts
 
+[storage1]
+recipe = zc.recipe.filestorage
+
 [server1]
 recipe = zc.zodbrecipes:server
 zeo.conf = 
@@ -17,9 +20,12 @@
     address 8101
     </zeo>
     <filestorage 1>
-    path /tmp/Data1.fs
+    path ${storage1:path}
     </filestorage>
 
+[storage2]
+recipe = zc.recipe.filestorage
+
 [server2]
 recipe = zc.zodbrecipes:server
 zeo.conf = 
@@ -27,7 +33,7 @@
     address 8102
     </zeo>
     <filestorage 1>
-    path /tmp/Data2.fs
+    path ${storage2:path}
     </filestorage>
 
 [zeoraid]


Property changes on: gocept.zeoraid/trunk/externals
___________________________________________________________________
Name: svn:externals
   + ZODB svn://svn.zope.org/repos/main/ZODB/branches/gocept-iteration/