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 >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 <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@xxxxxxxxxxxx
www.goldfisch.at
----
Cyrus Home Page: http://cyrusimap.web.cmu.edu/
Cyrus Wiki/FAQ: http://cyrusimap.web.cmu.edu/twiki
List Archives/Info: http://asg.web.cmu.edu/cyrus/mailing-list.html
