Dovecot 2.4 upgrade: wat ging er mis en hoe los je het op

Dovecot 2.4 is incompatibel met 2.3-configuratiebestanden. Geen geautomatiseerd migratiepad. Dit is wat er gebeurde en hoe ik het oploste.

Fluitje van een cent

In afwachting van beveiligingsupdates upgradde ik Dovecot op een Debian-server. Gewoon een fluitje van een cent, wat kan er misgaan?

Het probleem

Dovecot startte niet op. De error? Een ontbrekende config-parameter: dovecot_config_version. Maar dat was slechts het begin.

Wat er misging

Dovecot 2.4 introduceert ingrijpende wijzigingen:

• Configuratiebestanden van 2.3 zijn incompatibel
• Nieuwe syntax voor variabelen: %d is nu %{user | domain}
• Geen geautomatiseerd migratiepad
• Handmatige herschrijving van configuratie is vereist

De e-mailstack

E-mail is moeilijk. Niet omdat één component moeilijk is, maar omdat Postfix, Amavis, SpamAssassin, ClamAV en Dovecot naadloos moeten samenwerken. Als Dovecot niet start, valt de hele stack.

Hoe ik het oploste

1. De officiële upgrade handleiding grondig doorlezen
2. Elke config-parameter individueel controleren
3. De nieuwe syntax toepassen op SQL-backends, Sieve en aangepaste authenticatie
4. Afzonderlijk testen voordat de nieuwe config live gaat

Les

Onderschat een package upgrade nooit. Test altijd in een geïsoleerde omgeving voordat je een productie server aanraakt.