Upgrade iRedMail from 0.8.5 to 0.8.6

Attention

Check out the lightweight on-premises email archiving software developed by iRedMail team: Spider Email Archiver.

Paid Remote Upgrade Support

We offer remote upgrade support if you don't want to get your hands dirty, check the details and contact us.

Note

Policyd doesn't provide upgrade tutorial officially, so if you're running Policyd-1.8, please stay with it right now. Be patient and wait for our upgrade tutorial if you want to upgrade to Cluebringer.

ChangeLog

General (All backends must apply these steps)

Update /etc/iredmail-release with iRedMail version number

iRedMail stores the release version in /etc/iredmail-release after installation, it's recommended to update this file after you upgraded iRedMail, so that you can know which version of iRedMail you're running. For example:

# File: /etc/iredmail-release

0.8.6

Upgrade Roundcube webmail to the latest stable release

Please follow Roundcube official tutorial to upgrade Roundcube webmail to the latest stable release immediately: How to upgrade Roundcube.

Upgrade iRedAPD (Postfix policy server) to the latest stable release

Please follow below tutorial to upgrade iRedAPD to the latest stable release: Upgrade iRedAPD to the latest stable release

Upgrade iRedAdmin (open source edition) to the latest stable release

Please follow this tutorial to upgrade iRedAdmin open source edition to the latest stable release: Upgrade iRedAdmin to the latest stable release

Upgrade phpMyAdmin to the latest stable release

Please follow this short tutorial to upgrade phpMyAdmin to the latest stable release: http://docs.phpmyadmin.net/en/latest/setup.html#upgrading-from-an-older-version

Enable Opportunistic TLS support in Postfix when sending mail to remote SMTP server

This feature is used to secure your mail transaction when sending email from your iRedMail server (Postfix) to remote SMTP server. Refer to Postfix document for more technical details: smtp_tls_security_level

# postconf -e smtp_tls_security_level='may'
# postconf -e smtp_tls_CAfile='$smtpd_tls_CAfile'
# ---- On Linux ----
# /etc/init.d/postfix restart

# ---- On FreeBSD ----
# /usr/local/etc/rc.d/postfix restart

# ---- On OpenBSD ----
# /etc/rc.d/postfix restart

Alter Cluebringer database

IMPORTANT NOTE: This step is required if you're running Cluebringer. And please skip this step if you're running Policyd-1.8.

For better management, we have to do some modification on Cluebringer database, for example, add new columns, add new indexes. We have a SQL file you can use to finish this in one step.

Please download below two SQL files shipped in iRedMail-0.8.6, and save it as file /root/extra.sql, and /root/column_character_set.mysql:

For MySQL, please login to MySQL server as root user and import this sql file:

# mysql -uroot -p
mysql> USE cluebringer;
mysql> SOURCE /root/extra.sql;
mysql> SOURCE /root/column_character_set.mysql;

For PostgreSQL, please login to PostgreSQL admin user postgres and import this sql file:

# su - postgres
$ psql -d cluebringer
sql> \i /root/extra.sql;

That's all.

Add cron job to cleanup Cluebringer database

IMPORTANT NOTE: This step is required if you're running Cluebringer. And please skip this step if you're running Policyd-1.8.

We have to delete old/expired entries from database to keep SQL query fast.

NOTE: On RHEL/CentOS and openSUSE, you must update cluebringer package to version '2.0.13-3' with yum first:

# yum update cluebringer
# crontab -e -u root

Now add cron job:

1   3   *   *   *   /usr/sbin/cbpadmin --config=/etc/policyd/cluebringer.conf --cleanup > /dev/null
1   3   *   *   *   /usr/sbin/cbpadmin --config=/etc/cluebringer/cluebringer.conf --cleanup > /dev/null
1   3   *   *   *   /usr/local/bin/cbpadmin --config=/usr/local/etc/cluebringer.conf --cleanup > /dev/null