Upgrade/iRedMail/0.8.5-0.8.6

From iRedMail
(Difference between revisions)
Jump to: navigation, search

Revision as of 07:22, 8 January 2014

Contents



IMPORTANT NOTES:

  • 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. P.S. Policyd doesn't provide upgrade tutorial officially.


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 initial version number in /etc/iredmail-release after installation completed, 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 0.9.5

Please follow Roundcube official tutorial to upgrade Roundcube webmail to the latest 0.9.2 immediately: http://trac.roundcube.net/wiki/Howto_Upgrade

Upgrade iRedAPD (Postfix policy server) to the latest 1.4.2

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

Upgrade iRedAdmin (open source edition) to the latest 0.3

Please follow this tutorial to upgrade iRedAdmin open source edition to the latest stable release: How to upgrade iRedAdmin (open source edition) 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: http://www.postfix.org/postconf.5.html#smtp_tls_security_level

  • Add required parameters in Postfix:
Terminal:
# postconf -e smtp_tls_security_level='may'
# postconf -e smtp_tls_CAfile='$smtpd_tls_CAfile'
  • Then restart Postfix service:
Terminal:
# ---- 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:

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

Terminal:
# 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 '2.0.13-3' with yum first:

Terminal:
# yum update cluebringer
  • Add cron job with command 'crontab':
Terminal:
# crontab -e -u root

Now add cron job:

  • On RHEL/CentOS, openSUSE
1   3   *   *   *   /usr/sbin/cbpadmin --config=/etc/policyd/cluebringer.conf --cleanup > /dev/null
  • On Debian/Ubuntu:
1   3   *   *   *   /usr/sbin/cbpadmin --config=/etc/cluebringer/cluebringer.conf --cleanup > /dev/null
  • On FreeBSD:
1   3   *   *   *   /usr/local/bin/cbpadmin --config=/usr/local/etc/cluebringer.conf --cleanup > /dev/null
  • On OpenBSD: not required since OpenBSD doesn't have cluebringer package installed.
Personal tools