I hope this is a good way to ensure that something makes it into the release notes. A couple of people have already reported an upgrade issue which will cause some issues for people, and so it would be good to have this in the release notes:
In Fedora 26, The Cyrus IMAP server (cyrus-imapd) has been upgraded to version 3. This new version internally uses some new databases and new formats for existing databases. In the vast majority of cases it is sufficient to simply update the system and then follow the instructions beginning at https://cyrusimap.org/imap/download/upgrade.html#reconstruct-databases-and-cache to upgrade everything. It is, of course, always prudent to make backups of /var/lib/imap, /var/spool/imap, and any other locations you may have configured Cyrus to store mail or data.
However, if you are using a non-default database type configuration, have extensively modified your Cyrus configuration, or just with to exercise the maximum amount of caution, then it is prudent to follow https://cyrusimap.org/imap/download/upgrade.html#shut-down-existing-cyrus before you begin the upgrade. Cyrus 3 no longer supports the old 'berkeley' database type and so any databases in that format containing essential data must be converted to some other format prior to performing the upgrade.
Hi, yeah, this is definitely a good place to add things to release notes. I'll make sure this makes it in; thanks for bringing it to our attention.
Metadata Update from @pbokoc: - Issue assigned to pbokoc
Well, I spent a lot of time typing up a better release note which also mentioned some updated configuration settings. But pagure went away and I lost it all. So let me try again, if I'm not too late.
I don't think it's as good as what I did before, but this is the best I have time for right now.
In Fedora 26, The Cyrus IMAP server (cyrus-imapd) has been upgraded to version 3. This version brings significant new functionality, but it also has some new internal database formats. It has also changed the defaults for some important configuration settings. For these reasons it is important that you read and follow upstream's upgrade documentation beginning at https://cyrusimap.org/imap/download/upgrade.html#shut-down-existing-cyrus before you initiate an update to Fedora 26.
Some important things to note:
Cyrus version 3 has changed the defaults for two important configuration options: unixhierarchysep and altnamespace. If these aren't present in your existing configuration then you may wish to add them with their previously default value of "0".
unixhierarchysep
altnamespace
Cyrus version 3 no longer supports the berkeley database type. Thus if you have essential databases in that format, it is important that they be converted to a different format before you update your system. However, if you have already updated, don't panic. The default Fedora configuration does use this format, but only for non-essential databases which you will rebuild while following the update documentation.
berkeley
Thanks, @tibbs. The note is in the f26 version and should be published tomorrow (well, as long as we manage to publish anything).
https://pagure.io/release-notes/c/f584fa6a642c8d5e62470d5210813e6d0a3b9dba?branch=f26
(Closing the issue since I basically used the text above verbatim so I don't think it needs checking.)
Metadata Update from @pbokoc: - Issue close_status updated to: Fixed - Issue status updated to: Closed (was: Open)
Login to comment on this ticket.