• [gentoo-dev] news item draft: dovecot-2_4_upgrade

    From Eray Aslan@21:1/5 to All on Tue May 20 09:00:01 2025
    To be published ASAP, feedback welcome


    Title: net-mail/dovecot-2.4.x may break on upgrade
    Author: Eray Aslan <eras@gentoo.org>
    Posted: 2025-05-20
    Revision: 1
    News-Item-Format: 2.0
    Display-If-Installed: <net-mail/dovecot-2.4

    Dovecot-2.4 introduced breaking change to its entire configuration system and Dovecot-2.3 configuration files will NOT work after upgrade. Please read

    https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html

    before upgrading. We strongly recommend finalizing your Dovecot 2.4 configuration on a test system before upgrading any production systems.

    The following steps typically make the upgrade process easier:

    1. Make a note of your current configuration by running doveconf -n
    2. Stop the dovecot daemon
    3. Move ALL your configuration files to a temporary location
    4. Upgrade to doveocot-2.4.x
    5. Read the new configuration files and uncomment as necessary
    6. Compare the new doveconf -n output with the old one and add missing configuration settings one by one while checking that the system works after each change

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Zoltan Puskas@21:1/5 to Dale on Tue May 20 16:40:01 2025
    On Tue, May 20, 2025 at 02:30:06AM -0500, Dale wrote:
    Eray Aslan wrote:
    To be published ASAP, feedback welcome


    Title: net-mail/dovecot-2.4.x may break on upgrade
    Author: Eray Aslan <eras@gentoo.org>
    Posted: 2025-05-20
    Revision: 1
    News-Item-Format: 2.0
    Display-If-Installed: <net-mail/dovecot-2.4

    Dovecot-2.4 introduced breaking change to its entire configuration system and
    Dovecot-2.3 configuration files will NOT work after upgrade. Please read

    https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html

    before upgrading. We strongly recommend finalizing your Dovecot 2.4 configuration on a test system before upgrading any production systems.

    The following steps typically make the upgrade process easier:

    1. Make a note of your current configuration by running doveconf -n
    2. Stop the dovecot daemon
    3. Move ALL your configuration files to a temporary location
    4. Upgrade to doveocot-2.4.x
    5. Read the new configuration files and uncomment as necessary
    6. Compare the new doveconf -n output with the old one and add missing configuration settings one by one while checking that the system works after
    each change



    Spelling:

    4. Upgrade to doveocot-2.4.x

    should be

    4. Upgrade to dovecot-2.4.x
    ^^^^


    This looks great to me (beyond they small typo that already has been mentioned),
    concise and to the point. Thanks for writing it up quickly!

    Lowly user who changed keyboards, has to correct a LOT of spelling errors. LOL

    Also, shouldn't the user be alerted before upgrading not after? Maybe show even if the old version is installed since upgrade is coming? Kinda like the recent python upgrade.

    Eray's draft is for a news item, and as per

    Display-If-Installed: <net-mail/dovecot-2.4

    it will be shown to anyone who has a previous version of dovecot installed.


    Dale

    :-) :-)



    Zoltan

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Sam James@21:1/5 to Eray Aslan on Tue May 20 19:10:01 2025
    Eray Aslan <eras@gentoo.org> writes:

    To be published ASAP, feedback welcome


    Title: net-mail/dovecot-2.4.x may break on upgrade
    Author: Eray Aslan <eras@gentoo.org>
    Posted: 2025-05-20
    Revision: 1
    News-Item-Format: 2.0


    LGTM. Thanks for doing this. One comment below.

    Display-If-Installed: <net-mail/dovecot-2.4

    Let's change this, as it's already unmasked, people won't see this news
    item if they upgraded and wonder what's going on. Let's just make it net-mail/dovecot?


    Dovecot-2.4 introduced breaking change to its entire configuration system and Dovecot-2.3 configuration files will NOT work after upgrade. Please read

    https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html

    before upgrading. We strongly recommend finalizing your Dovecot 2.4 configuration on a test system before upgrading any production systems.

    The following steps typically make the upgrade process easier:

    1. Make a note of your current configuration by running doveconf -n
    2. Stop the dovecot daemon
    3. Move ALL your configuration files to a temporary location
    4. Upgrade to doveocot-2.4.x
    5. Read the new configuration files and uncomment as necessary
    6. Compare the new doveconf -n output with the old one and add missing configuration settings one by one while checking that the system works after each change

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Eray Aslan@21:1/5 to Dale on Wed May 21 08:00:01 2025
    On Tue, May 20, 2025 at 02:30:06AM -0500, Dale wrote:
    Spelling:

    4. Upgrade to doveocot-2.4.x

    should be

    4. Upgrade to dovecot-2.4.x
    ^^^^

    Fixed. Thanks
    --
    Eray

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Eray Aslan@21:1/5 to Sam James on Wed May 21 08:10:01 2025
    On Tue, May 20, 2025 at 06:00:03PM +0100, Sam James wrote:
    Eray Aslan <eras@gentoo.org> writes:
    Display-If-Installed: <net-mail/dovecot-2.4

    Let's change this, as it's already unmasked, people won't see this news
    item if they upgraded and wonder what's going on. Let's just make it net-mail/dovecot?

    Done
    --
    Eray

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)