Upgrade/iRedMail/0.8.1-0.8.2
From iRedMail
Contents |
THIS TUTORIAL IS A DRAFT. DO NOT APPLY IT.
Usually, upgrading iRedMail is just updating some config files to achieve new features or fix bugs, you do NOT need to download the latest iRedMail and run the script.
IMPORTANT NOTE: Upgrades are only supported from one release to the release immediately following it. Do not skip releases.
ChangeLog
- 2012-06-22: [LDAP] Return correct maildir path while using virtual transport.
- 2012-06-21: Add missing log rotate setting for Dovecot log files on OpenBSD and FreeBSD.
- 2012-06-17: Use the latest iRedMail LDAP schema file.
- 2012-06-14: Fix incorrect log rotate setting for iRedAPD on FreeBSD.
General (All backends should apply these upgrade steps)
[OpenBSD only] Add missing log rotate settings for Dovecot log files
NOTE: This is only applicable to OpenBSD.
Please add below two lines in /etc/newsyslog.conf to rotate Dovecot log files: /var/log/dovecot.log, /var/log/sieve.log.
| File: /etc/newsyslog.conf |
/var/log/dovecot.log vmail:vmail 600 7 * 24 Z "doveadm log reopen" /var/log/sieve.log vmail:vmail 600 7 * 24 Z "doveadm log reopen" |
[FreeBSD only] Add missing log rotate settings for Dovecot log files
NOTE: This fix is only applicable to FreeBSD.
Please add below two lines in /etc/newsyslog.conf to rotate Dovecot log files: /var/log/dovecot.log, /var/log/sieve.log.
| File: /etc/newsyslog.conf |
/var/log/dovecot.log vmail:vmail 600 7 * 24 Z /var/run/dovecot/master.pid /var/log/sieve.log vmail:vmail 600 7 * 24 Z /var/run/dovecot/master.pid |
[FreeBSD only] Fix incorrect rotate setting for iRedAPD log file
NOTE: This fix is only applicable to FreeBSD.
iRedMail-0.8.1 defines incorrectly path of iRedAPD PID file in /etc/newsyslog.conf, so please fix it manually by editing /etc/newsyslog.conf.
- Make sure you have below line in /etc/newsyslog.conf:
| File: /etc/newsyslog.conf |
/var/log/iredapd.log root:wheel 640 7 * 24 Z /var/run/iredapd.pid |
Be careful, don't use quotes around path of pid file.
- Then restart syslogd service:
| Terminal: |
# /etc/rc.d/syslogd restart |
OpenLDAP backend special
Use newest schema file
New LDAP schema file shipped in iRedMail-0.8.2 allows normal mail user to use attribute domainGlobalAdmin. With this attribute, you can mark mail user as a global admin to manage mail accounts with iRedAdmin-Pro.
To use the newest iRedMail ldap schem file, we have to:
- Download the newest iRedMail ldap schema file
- Copy old ldap schema file as a backup copy
- Replace the old one
- Restart OpenLDAP service.
Here we go:
- On RHEL/CentOS/Scientific Linux (both release 5.x and 6.x), openSUSE, Gentoo, OpenBSD:
| Terminal: |
# cd /tmp # wget https://bitbucket.org/zhb/iredmail/raw/b4dd5c080967/iRedMail/samples/iredmail.schema # cd /etc/openldap/schema/ # cp iredmail.schema iredmail.schema.bak # cp -f /tmp/iredmail.schema /etc/openldap/schema/ # /etc/init.d/slapd restart # <-- Or: /etc/init.d/ldap restart |
- On Debian/Ubuntu:
| Terminal: |
# cd /tmp # wget https://bitbucket.org/zhb/iredmail/raw/b4dd5c080967/iRedMail/samples/iredmail.schema # cd /etc/ldap/schema/ # cp iredmail.schema iredmail.schema.bak # cp -f /tmp/iredmail.schema /etc/ldap/schema/ # /etc/init.d/ldap restart |
- On FreeBSD:
| Terminal: |
# cd /tmp # wget https://bitbucket.org/zhb/iredmail/raw/b4dd5c080967/iRedMail/samples/iredmail.schema # cd /usr/local/etc/ldap/schema/ # cp iredmail.schema iredmail.schema.bak # cp -f /tmp/iredmail.schema /usr/local/etc/openldap/schema/ # /etc/init.d/ldap restart |
Return correct maildir path while using virtual transport
Postfix setting virtual_mailbox_maps doesn't return correct maildir path. Usually, this is fine because iRedMail uses transport program provided by Dovecot (command name deliver). But if you want to use Postfix built-in transport program virtual, mails will be delivered to incorrect path.
To fix it, please open /etc/postfix/ldap/virtual_mailbox_maps.cf (Linux and OpenBSD) or /usr/local/etc/postfix/ldap/virtual_mailbox_maps.cf (FreeBSD), append parameter result_format = %s/Maildir/ line after line result_attribute= mailMessageStore.
| File: /etc/postfix/ldap/virtual_mailbox_maps.cf |
result_attribute = mailMessageStore result_format = %s/Maildir/ |
Restarting Postfix service is required.
