svn commit: r530244 - in /xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading: index.xml one-oh.xml one-one.xml

Author: vgritsenko
Date: Wed Apr 18 20:03:19 2007
New Revision: 530244

URL: http://svn.apache.org/viewvc?view=rev&rev=530244
Log:
add alternative to rebuild tool

Modified:
    xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/index.xml
    xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-oh.xml
    xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-one.xml

Modified: xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/index.xml
URL: http://svn.apache.org/viewvc/xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/index.xml?view=diff&rev=530244&r1=530243&r2=530244
==============================================================================
--- xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/index.xml (original)
+++ xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/index.xml Wed Apr 18 20:03:19 2007
@@ -40,10 +40,10 @@
   </audience>
   <prerequisites title="Prerequisites">
     <p>
-      Backup. Always back up your database before starting an upgrade.
+      Shutdown. Shutdown the database before starting an upgrade.
     </p>
     <p>
-      Shutdown. Shutdown the database before starting an upgrade.
+      Backup. Always back up your database before starting an upgrade.
     </p>
   </prerequisites>
 

Modified: xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-oh.xml
URL: http://svn.apache.org/viewvc/xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-oh.xml?view=diff&rev=530244&r1=530243&r2=530244
==============================================================================
--- xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-oh.xml (original)
+++ xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-oh.xml Wed Apr 18 20:03:19 2007
@@ -63,20 +63,15 @@
         <strong>XMLObjects.</strong> Xindice 1.1 does not have support for Xindice 1.0
         XMLObjects.
       </li>
-      <li>
-        Something else?
-      </li>
     </ul>
   </steps>
 
   <steps title="Steps">
-    <p>Follow procedure:</p>
-    <ul>
-      <li>Do this
-      </li>
-      <li>And this
-      </li>
-    </ul>
+    <p>
+      Despite all of the differences, steps for upgrading from Xindice 1.0 are all
+      the same as if upgrading from any of Xindice 1.1 betas. Please follow the steps
+      outlined <link href="one-one.html">here</link>.
+    </p>
 
     <p>If you run into problems, don't worry.  Be sure to send <link href="../../../mail.html">feedback</link> so that we can improve these documents for the next person.</p>
   </steps>

Modified: xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-one.xml
URL: http://svn.apache.org/viewvc/xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-one.xml?view=diff&rev=530244&r1=530243&r2=530244
==============================================================================
--- xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-one.xml (original)
+++ xml/xindice/trunk/src/documentation/content/xdocs/community/howto/upgrading/one-one.xml Wed Apr 18 20:03:19 2007
@@ -102,10 +102,75 @@
         (If using XINDICE_DB_HOME variable, substitute 'db' with '$XINDICE_DB_HOME/db'.)
       </li>
       <li>
-        Check tool output for any problems.
+        Check tool output for any problems. If any of the collections or indeces could
+        not be rebuilt to new format, do not panic - just follow an alternate approach
+        outlined below.
       </li>
       <li>
         Test resulting database using command line tool.
+      </li>
+    </ul>
+  </steps>
+
+  <steps title="Alternate Procedure">
+    <p>
+      If any of the collections or indeces could not be converted to new format,
+      follow these steps. To migrate collections over to the new database:
+    </p>
+    <ul>
+      <li>
+        Start old Xindice database (using backed up data files).
+      </li>
+      <li>
+        Export all documents from affected collections (replace &lt;name&gt; with
+        collection path):<br/>
+        (Unix):
+        <source>
+    mkdir export
+    ./bin/xindiceadmin export -c /db/&lt;name&gt; -f export</source>
+        (Windows):
+        <source>
+    mkdir export
+    bin\xindiceadmin export -c /db/&lt;name&gt; -f export</source>
+      </li>
+      <li>
+        Stop old Xindice database.
+      </li>
+      <li>
+        Start new database.
+      </li>
+      <li>
+        Recreate collections in the new database.
+      </li>
+      <li>
+        Delete corrupted collections from new database using command line tool. This
+        should also remove all data files and index files of these collections.
+      </li>
+      <li>
+        Import all documents into the new database:<br/>
+        (Unix):
+        <source>
+    ./bin/xindice import -c /db -f export/&lt;name&gt;</source>
+        (Windows):
+        <source>
+    bin\xindice import -c /db -f export\&lt;name&gt;</source>
+      </li>
+      <li>
+        Create all indexes which were present in the old database.
+      </li>
+    </ul>
+    <p>
+      For indeces which can not be converted:
+    </p>
+    <ul>
+      <li>
+        Start new database.
+      </li>
+      <li>
+        Drop corrupted indeces.
+      </li>
+      <li>
+        Recreate indeces anew.
       </li>
     </ul>