improvements and corrections in the upgrade-documentatin

[peter pilsl]

Ken Murchison wrote:
> 
> Could you send a patch against the current documentation that 
> incorporates your changes?
> 

Here is the patch:

==================================================================================
diff -Naur old/install-upgrade.html new/install-upgrade.html
--- old/install-upgrade.html    2007-01-24 11:05:41.000000000 +0100
+++ new/install-upgrade.html    2007-01-24 11:15:56.000000000 +0100
@@ -86,44 +86,34 @@
  <h3>General information (ALL SITES)</h3>

  <ul>
-<li>The default database formats for the mailbox list state databases
-has been changed to the skiplist backend. There are two ways of dealing
-with this if you have been using the defaults. You can stay with your
-old formats or convert to the new format. We believe that the new
-skiplist offers considerable performance advantages for these two
-databases over the previous defaults. </li>
-
-
-
+<li>The default database formats for the mailbox list state databases has been
+changed to the skiplist backend. There are two ways of dealing with this if
+you have been using the defaults. You can stay with your old formats or convert
+to the new format. We believe that the new skiplist offers considerable 
performance
+advantages for these two databases over the previous defaults.
+</li>
  <ol>
-<li>Specify <tt>--with-mboxlist-db=berkeley</tt> and
-<tt>--with-seen-db=flat</tt> to <tt>configure</tt>.  This will
-instruct Cyrus to continue to use the previous defaults.</li>
-
-<li> You need to convert the databases. <tt>cvt_cyrusdb</tt> can do this for you.
-This should be done with the server down, and with the binaries from the new
-Cyrus distribution.  Change any paths that do not match your configuration.<br>
+<li>Specify <tt>--with-mboxlist-db=berkeley</tt> and 
<tt>--with-seen-db=flat</tt> to <tt>configure</tt>.
+This will instruct Cyrus to continue to use the previous defaults.
+</li>
+<li> You need to convert the databases. <tt>cvt_cyrusdb</tt> can do this for you.
+This should be done with the server down, and with the binaries from the new Cyrus
+distribution.  Change any paths that do not match your configuration.<br>
  </li>
  <ul>
  <li>For the mailbox list, the command looks like:
  <pre>/usr/cyrus/bin/cvt_cyrusdb /var/imap/mailboxes.db berkeley 
/var/imap/mailboxes.db.new skiplist
  mv /var/imap/mailboxes.db.new /var/imap/mailboxes.db
  </pre>
-Note that the use of full paths to the database files is important.  You
-should also backup your old mailboxes database before moving the new one
-in.<br>
-Note that the above method does not work, if you are changing the
-Version of your Berkeley-DB as well (ie: moving from one machine to
-another). You'll get an error "can't not open old database" and
-berkeley-errors in your log. In this case you can perform the following
-procedure instead of using cvt_cyrusdb:
+Note that the use of full paths to the database files is important. You should 
also backup your old mailboxes database before moving the new one in.<br>
+Note that the above method does not work, if you are changing the Version of 
your Berkeley-DB as well (ie: moving from one machine to another). You'll get an 
error "can't not open old database" and berkeley-errors in your log. In this 
case you can perform the following procedure instead of using cvt_cyrusdb:
  <ol>
  <li>use <tt>ctl_mailbox -d &gt;mailboxes.db.dump</tt> on your old 
cyrus-installation with your old cyrus-binary</li>
  <li>delete db - folder in the config-directory on your new installation and 
create a new empty one that is owned by your cyrus-user</li>
  <li>create an empty mailboxes.db-file in the new config-directory that is 
owned by cyrus</li>
  <li>usr <tt>ctl_mailbox -u &lt;mailboxes.db.dump</tt> on your new 
cyrus-installation with your new cyrus-binary to get the skiplist-formatted 
mailboxes.db</li>
  </ol>
-</li><li> For the seen state databases, the command to get them all in one fell 
swoop
+<li> For the seen state databases, the command to get them all in one fell swoop
  looks like:
  <pre>find /var/imap/user -name \*.seen -exec /usr/cyrus/bin/cvt_cyrusdb \{\} 
flat \{\}.new skiplist \; -exec mv \{\}.new \{\} \;
  </pre>
@@ -134,7 +124,7 @@
  especially if your databases are large.
  </li>
  </ul>
-</ol>
+</li></ol>

  <li>Sieve scripts are now compiled into bytecode.  The program
  <tt>sievec</tt> is provided to do this process manually (timsieved will
@@ -270,10 +260,7 @@
  </li><li> If you have enabled the improved directory hashing scheme, run
  the script "<tt>tools/rehash full</tt>".  This script will rehash your
  existing directories.<br>
-<b>Note that there are several reports of rehash not working properly</b>
-and messing up your whole cyrus-data. So disabling the improved hashing
-scheme and not running rehash is recommended if you want to be on the
-save side. <b>You have been warned</b>
+<b>Note that there are several reports of rehash not working properly</b> and 
messing up your whole cyrus-data. So disabling the improved hashing scheme and 
not running rehash is recommended if you want to be on the save side. <b>You 
have been warned</b>

  </li><li> The hashed deliver databases (used for duplicate delivery suppression
  and Sieve) have been merged into a single <tt>deliver.db</tt> database.
==================================================================================


best,
peter


-- 
mag. peter pilsl - goldfisch.at
IT-Consulting
Tel: +43-650-3574035
Tel: +43-1-8900602
Fax: +43-1-8900602-15
skype: peter.pilsl
pilsl at goldfisch.at
www.goldfisch.at