5.0 KiB

Raw Blame History

Upgrade iRedMail from 0.8.5 to 0.8.6

[TOC]

!!! note "Paid Remote Upgrade Support"

We offer remote upgrade support if you don't want to get your hands dirty,
check [the details](https://www.iredmail.org/support.html) and
[contact us](https://www.iredmail.org/contact.html).

!!! 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

2014-01-08: Remove backup mx related sections, it's wrong.
2013-12-17: New section: Alter Cluebringer database.
2013-12-17: public release.
2013-11-30: Check whether hosted domain is backup mx or not in Postfix transport map query.
2013-09-14: Add cron job to cleanup Cluebringer database.
2013-09-2: Enable Opportunistic TLS support in Postfix when sending mail to remote SMTP server.
2013-08-25: Upgrade Roundcube to 0.9.3.

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

Add required parameters in Postfix:

# postconf -e smtp_tls_security_level='may'
# postconf -e smtp_tls_CAfile='$smtpd_tls_CAfile'

Then restart Postfix service:

# ---- 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