[Zope-Checkins] SVN: Zope/trunk/doc/ documentation for manage_convertIndexes

[Andreas Jung]

Log message for revision 29126:
  documentation for manage_convertIndexes
  

Changed:
  U   Zope/trunk/doc/CHANGES.txt
  U   Zope/trunk/doc/FAQ.txt

-=-
Modified: Zope/trunk/doc/CHANGES.txt
===================================================================
--- Zope/trunk/doc/CHANGES.txt	2005-02-12 15:52:06 UTC (rev 29125)
+++ Zope/trunk/doc/CHANGES.txt	2005-02-12 16:04:58 UTC (rev 29126)
@@ -395,7 +395,8 @@
      - Collector #1595: same as in Collector #1132 for indexes derived from
        UnIndex. Exisiting ZCatalog instances must be converted manually
        by calling the "manage_convertIndexes" method through-the-web for 
-       every single ZCatalog instance.
+       every single ZCatalog instance. See also doc/FAQ.txt (Installation,
+       question #4)
 
      - Collector #1457: ZCTextIndex's QueryError and ParseError
        are now available for import from untrusted code.

Modified: Zope/trunk/doc/FAQ.txt
===================================================================
--- Zope/trunk/doc/FAQ.txt	2005-02-12 15:52:06 UTC (rev 29125)
+++ Zope/trunk/doc/FAQ.txt	2005-02-12 16:04:58 UTC (rev 29126)
@@ -194,6 +194,33 @@
        (yay) it's var/z2.pid, for pcgi (not so yay), it's
        var/pcgi.pid.
 
+    4. After moving my old Data.fs to Zope 2.8 I get an 
+       "AttributeError, _length" when trying to use the ZCatalog?
+
+       In Zope 2.8 we cleaned up the index implementations and therefore
+       you need to migrate every single ZCatalog manually:
+
+        - go to the ZMI 
+
+        - click on your ZCatalog instance (or portal_catalog inside
+          your CMF or Plone instance)
+
+        - you will get an "AttributeError, _length"...don't panic
+
+        - call the "manage_convertIndexes" method of the ZCatalog 
+          (by replacing the "manage_main" part of the URL with
+           "manage_convertIndexes")
+
+        - depending on the size of your ZCatalog the migration may
+          take a while
+
+        - after the conversion a message will appear: "Indexes
+          converted and reindexes"
+
+        - Notice: **YOU SHOULD BACKUP YOUR var/Data.fs file before
+          starting the migration**
+
+
   General