[Checkins] SVN: gocept.zeoraid/trunk/ - Documented the various cases of blob support.

[Christian Theune]

Log message for revision 85799:
  - Documented the various cases of blob support.
  - added todo items for blob support
  - ignoring the buildout egg directory
  

Changed:
  _U  gocept.zeoraid/trunk/
  U   gocept.zeoraid/trunk/TODO.txt
  A   gocept.zeoraid/trunk/doc/BLOBS.txt

-=-

Property changes on: gocept.zeoraid/trunk
___________________________________________________________________
Name: svn:ignore
   - develop-eggs
buildout.cfg
dist
bin
parts
.installed.cfg

   + develop-eggs
eggs
buildout.cfg
dist
bin
parts
.installed.cfg


Modified: gocept.zeoraid/trunk/TODO.txt
===================================================================
--- gocept.zeoraid/trunk/TODO.txt	2008-04-28 08:44:52 UTC (rev 85798)
+++ gocept.zeoraid/trunk/TODO.txt	2008-04-28 12:19:51 UTC (rev 85799)
@@ -44,9 +44,6 @@
 
 - Pack may never be run while a storage is recovering.
 
-- Blobs: Hard links created for the multiple backend storages need to be
-  tracked and cleaned up.
-
 - Windows support
 
 Feature-completeness
@@ -56,6 +53,15 @@
 
 - Support undo.
 
+Blob support
+-------------
+
+- Create flag `shared-blob-dir` for RAIDStorage
+- Functionality for shared blob-dir
+- Functionality for unshared blob-dir
+  - clean up unconsumed hard links
+  - clean up temporary directories
+
 Cleanup
 -------
 

Added: gocept.zeoraid/trunk/doc/BLOBS.txt
===================================================================
--- gocept.zeoraid/trunk/doc/BLOBS.txt	                        (rev 0)
+++ gocept.zeoraid/trunk/doc/BLOBS.txt	2008-04-28 12:19:51 UTC (rev 85799)
@@ -0,0 +1,51 @@
+
+All valid front end configurations can be combined with all valid back end configurations.
+
+Front end configuration
+=======================
+
+No support or no blob support configured
+----------------------------------------
+
+- andere einstellungen sind irrelevant, sollten auf `unconfigured` stehen
+
+Blobs via ZEO protocol
+----------------------
+
+ClientStorage options:
+- blob-dir configured to a seperate physical directory on each client
+- shared-blob-dir set to `false`
+
+Blobs via file system shared with ZEORaid
+-----------------------------------------
+
+- blob-dir configured to a directory shared between the zeo clients and the RAIDStorage's blob-directory (read/write for all participants)
+- shared-blob-dir set to `true`
+
+Back end configuration
+======================
+
+RAIDStorage and back-end both with shared file system
+-----------------------------------------------------
+
+- blob-dir configured to a directory shared between raidstorage, clientstorages and back-end servers (read/write for all participants)
+- shared-blob-dir for raidstorage and clientstorages set to `true`
+
+RAIDStorage via storage API and back end via ZEO protocol
+---------------------------------------------------------
+
+- blob-dir configured to separate directories in raidstorage, clientstorages and back-end servers 
+- shared-blob-dir for raidstorage and clientstorages set to `false`
+
+
+Invalid combinations: mixture of shared and non-shared
+------------------------------------------------------
+
+- The raidstorage having a shared directory with the zeo clients but the zeo
+clients not sharing with the back end servers is unsupported.
+
+- The raidstorage using the storage API against zeo clients which share their
+blob directory is unsupported.
+
+Warning: ZEORaid can not automatically detect those invalid combinations and might destroy data if those are configured.
+


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