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 <name>
with
+ collection path):<br/>
+ (Unix):
+ <source>
+ mkdir export
+ ./bin/xindiceadmin export -c /db/<name> -f export</source>
+ (Windows):
+ <source>
+ mkdir export
+ bin\xindiceadmin export -c /db/<name> -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/<name></source>
+ (Windows):
+ <source>
+ bin\xindice import -c /db -f export\<name></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>
