[Checkins] SVN: gocept.zeoraid/trunk/ Add installation instructions
for alpha testing.
Christian Theune
ct at gocept.com
Tue Feb 26 01:54:51 EST 2008
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/
More information about the Checkins
mailing list