Managing IMAP

Upgrading from Previous Versions of Cyrus IMAP

Fresh installation of Cyrus may be all well trodden territory for you. If you’re upgrading from a previous version of Cyrus IMAP, however, there are a few cleanup tasks to take care of after your upgrade. In addition to the notes that follow, be sure to read the contents of the doc directory carefully, with particular attention to the notes on upgrading.

• If you’re upgrading from Version 1.5.2 or earlier, delete your delivered database and your PTS cache database (if you use the AFS filesystem), if they exist. If you’ve previously enabled duplicate delivery suppression, the delivered database (delivered.db) is in your configuration directory. If you use AFS PTS group support, the PTS cache is in /var/ptclient. Deleting both these files has no deleterious effects except that, in the case of the delivered database, some duplicate messages may be delivered.

• If you’re upgrading from Version 1.4 or earlier, you must run reconstruct –r after installing the software and before putting it into production, so that the indexes for all your system’s mailboxes are rebuilt.

• If you’re upgrading from Version 1.3 or earlier, you’ll also have to run a reconstruct –m to rebuild your mailboxes file.

• Finally, if you run imspd and imapd on the same machine and use AFS ACLs, you’ll need to be running at least Version 1.5a5 of the IMSP server, because the format of the PTS cache for IMSP has changed.