iRedMail   //  Document Index

Upgrade Dovecot from 2.2.x to 2.3.x

Dovecot 2.3 breaks some backward compatible, and here's a short tutorial to convert your Dovecot 2.2 config file to fully work with Dovecot 2.3.

For more details, please read Dovecot wiki page: Upgrading Dovecot v2.2 to v2.3.

Upgrade Dovecot on Linux/FreeBSD/OpenBSD

Open a shell terminal, and switch to Dovecot configuration directory first:

• On Linux/OpenBSD:

cd /etc/dovecot/

• On FreeBSD:
  • Please upgrade ports mail/dovecot and mail/dovecot-pigeonhole first. You can use tool like portmaster or portupgrade for this purpose. FYI: Using the Ports Collection
  • After upgraded both ports, please run:

cd /usr/local/etc/dovecot/

Run commands below as root user, these commands will:

• Comment out parameter ssl_protocols
• Remove parameter postmaster_address
• Rename plugin names and parameters:
  • stats -> old_stats
  • imap_status -> imap_old_stats
  • stats_refresh -> old_stats_refresh
  • service stats {} -> service old-stats {}
  • fifo_listener stats-mail {} -> fifo_listener old-stats-mail {}
  • stats_track_cmds -> old_stats_track_cmds

perl -pi -e 's/^ssl_protocols/#${1}/g' dovecot.conf
perl -pi -e 's#(postmaster_address.*)##g' dovecot.conf
perl -pi -e 's#^(mail_plugins.*) stats(.*)#${1} old_stats${2}#g' dovecot.conf
perl -pi -e 's#imap_stats#imap_old_stats#g' dovecot.conf
perl -pi -e 's#service stats#service old-stats#g' dovecot.conf
perl -pi -e 's#fifo_listener stats-mail#fifo_listener old-stats-mail#g' dovecot.conf
perl -pi -e 's#stats_refresh#old_stats_refresh#g' dovecot.conf
perl -pi -e 's#stats_track_cmds#old_stats_track_cmds#g' dovecot.conf

• On RHEL/CentOS, please add new setting in dovecot.conf:

ssl_dh = </etc/pki/tls/dh2048_param.pem

• On Debian/Ubuntu/OpenBSD/FreeBSD, please add new setting in dovecot.conf:

ssl_dh = </etc/ssl/dh2048_param.pem

SQL structure changes for MySQL/MariaDB/PostgreSQL backends

Dovecot-2.3 changes the flag for TLS secure connections internally, it's used by iRedMail to detect the connection type. We need to create a new SQL column for this change.

• For MySQL/MariaDB, please login to SQL server as root user, then run SQL commands below:

USE vmail;
ALTER TABLE mailbox ADD COLUMN enableimaptls TINYINT(1) NOT NULL DEFAULT 1;
ALTER TABLE mailbox ADD INDEX (enableimaptls);
ALTER TABLE mailbox ADD COLUMN enablepop3tls TINYINT(1) NOT NULL DEFAULT 1;
ALTER TABLE mailbox ADD INDEX (enablepop3tls);

• For PostgreSQL backend, please switch to PostgreSQL daemon user with su command first, then run SQL commands below:

\c vmail;
ALTER TABLE mailbox ADD COLUMN enableimaptls INT2 NOT NULL DEFAULT 1;
CREATE INDEX idx_mailbox_enableimaptls ON mailbox (enableimaptls);
ALTER TABLE mailbox ADD COLUMN enablepop3tls INT2 NOT NULL DEFAULT 1;
CREATE INDEX idx_mailbox_enablepop3tls ON mailbox (enablepop3tls);