+ ++
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.
-Note: Upgrades are only supported from one release to the release -immediately following it. Do NOT skip releases.
-If you're looking for upgrading a very old iRedMail server to a new one, -there's an alternative solution: Migrating to a new iRedMail server.
-You can always download the latest iRedMail release on Download page.
+ features or fix bugs, you do NOT need to download the latest iRedMail and + run the script. +Upgrades are only supported from one release to the release immediately + following it. Do NOT skip releases.
+If you're looking for upgrading a very old iRedMail server to the latest + iRedMail release, there's an alternative solution: + Migrating to a new iRedMail server.
+mailbox.language in MySQL & PGSQL backends, used by iRedAdmin.NOTE: This is applicable to only Dovecot-2.x. You can check Dovecot version +and its main config file with command:
+# dovecot -n | head -1
+2.0.17 ...
+/etc/dovecot/dovecot.conf, add service auth-userdb in section service auth {}:# Part of file: dovecot.conf
+
+service auth {
+ ...
+ unix_listener auth-userdb {
+ user = vmail
+ group = vmail
+ mode = 0660
+ }
+}
+NOTE: This is applicable to both Dovecot-1.2 and Dovecot-2.
+Edit /etc/dovecot/dovecot-share-folder.conf, append below lines:
/etc/dovecot/share-folder.conf if you're running old
+ iRedMail versions, and it's /usr/local/etc/dovecot/dovecot-share-folder.conf
+ on FreeBSD.# Part of file: dovecot-share-folder.conf
+
+# To share mailbox to anyone, please uncomment 'acl_anyone = allow' in
+# dovecot.conf
+map {
+ pattern = shared/shared-boxes/anyone/$from
+ table = anyone_shares
+ value_field = dummy
+ fields {
+ from_user = $from
+ }
+}
+Note: We will mention how to create required SQL table later in this upgrade tutorial.
+NOTE: This fix is only applicable to FreeBSD and OpenBSD.
+/etc/newsyslog.conf to rotate
+ iRedAPD log file:# Part of file: /etc/newsyslog.conf
+
+/var/log/iredapd.log root:wheel 640 7 * 24 Z /var/run/iredapd.pid
+/etc/newsyslog.conf to rotate
+ iRedAPD log file:# Part of file: /etc/newsyslog.conf
+
+/var/log/iredapd.log root:wheel 640 7 * 24 Z "/etc/rc.d/iredapd restart"
+Then restart syslogd service on either FreeBSD or OpenBSD:
+# /etc/rc.d/syslogd restart
+enabledService=smtpWith default Postfix settings in iRedMail-0.7.4 and earlier versions, if a mail
+user is not allowed to use SMTP service to send out email (without
+enabledService=smtp), user cannot receive emails which delivered to the mail
+lists which the user belongs to. Below steps fix this issue.
Edit Postfix config file, main.cf, update virtual_alias_maps to replace
+ sender_login_maps.cf by virtual_group_members_maps.cf:
/etc/postfix/main.cf./usr/local/etc/postfix/main.cf. And you should use
+ /usr/local/etc/postfix/ldap/virtual_group_members_maps.cf in Postfix
+ setting described below.# Part of file: main.cf
+
+# OLD SETTING
+#virtual_alias_maps = ..., proxy:ldap:/etc/postfix/ldap/sender_login_maps.cf, ...
+
+# NEW SETTING
+virtual_alias_maps = ..., proxy:ldap:/etc/postfix/ldap/virtual_group_members_maps.cf, ...
+Create new file virtual_group_members_maps.cf:
sender_login_maps.cf to virtual_group_members_maps.cf.virtual_group_members_maps.cf, replace enabledService=smtp by enabledService=deliver and save it.# Part of file: virtual_group_members_maps.cf
+
+# ---- OLD SETTING ----
+#query_filter = ...(enabledService=smtp)...
+
+# ---- NEW SETTING ----
+query_filter = ...(enabledService=deliver)...
+# ---- On Linux and FreeBSD ----
+# chown root:postfix virtual_group_members_maps.cf
+# chmod 0640 virtual_group_members_maps.cf
+
+# ---- On OpenBSD ----
+# chown root:_postfix virtual_group_members_maps.cf
+# chmod 0640 virtual_group_members_maps.cf
+enabledService=lib-storageNote: This step is required in Dovecot-2.x, but you must apply it no matter +which Dovecot version you're running, so that it won't be an issue while you +upgrading from Dovecot-1.x to 2.x.
+Dovecot-2.x requires enabledService=lib-storage for IMAP folder sharing.
+Below steps are used to add it for all mail users.
# cd /root/
+# wget https://bitbucket.org/zhb/iredmail/raw/cb7d2492563d/extra/update/updateLDAPValues_080_to_081.py
+updateLDAPValues_080_to_081.py, config LDAP server related settings in
+ file head. e.g.# Part of file: updateLDAPValues_080_to_081.py
+
+uri = 'ldap://127.0.0.1:389'
+basedn = 'o=domains,dc=iredmail,dc=org'
+bind_dn = 'cn=vmailadmin,dc=iredmail,dc=org'
+bind_pw = 'passwd'
+You can find required LDAP credential in iRedAdmin config file or iRedMail.tips
+file under your iRedMail installation directory. Using either
+cn=Manager,dc=xx,dc=xx or cn=vmailadmin,dc=xx,dc=xx as bind dn is ok.
# python updateLDAPValues_080_to_081.py
+anyone_shares in MySQL database iredadminIf you want to share IMAP folder to anyone, you have to create new SQL table
+anyone_shares in MySQL database iredadmin. Steps:
# mysql -uroot -p
+sql> USE iredadmin;
+sql> CREATE TABLE IF NOT EXISTS anyone_shares (
+ from_user VARCHAR(255) NOT NULL,
+ dummy CHAR(1) DEFAULT '1',
+ PRIMARY KEY (from_user)
+);
+To make sure per-user BCC settings have higher priority than per-domain
+settings, please edit Postfix main config file main.cf, reverse the lookup
+maps in both sender_bcc_maps and recipient_bcc_maps.
* On Linux and OpenBSD, it's `/etc/postfix/main.cf`.
+* On FreeBSD, it's `/usr/local/etc/postfix/main.cf`.
+# Part of file: main.cf
+
+# OLD SETTINGS
+#recipient_bcc_maps = proxy:ldap:/etc/postfix/ldap/recipient_bcc_maps_domain.cf, proxy:ldap:/etc/postfix/ldap/recipient_bcc_maps_user.cf
+#sender_bcc_maps = proxy:ldap:/etc/postfix/ldap/sender_bcc_maps_domain.cf, proxy:ldap:/etc/postfix/ldap/sender_bcc_maps_user.cf
+
+# NEW SETTINGS
+recipient_bcc_maps = proxy:ldap:/etc/postfix/ldap/recipient_bcc_maps_user.cf, proxy:ldap:/etc/postfix/ldap/recipient_bcc_maps_domain.cf
+sender_bcc_maps = proxy:ldap:/etc/postfix/ldap/sender_bcc_maps_user.cf, proxy:ldap:/etc/postfix/ldap/sender_bcc_maps_domain.cf
+iRedMail uses Dovecot LDA as transport by default, but if you use transport
+virtual, the Postfix built-in transport, it will use different maildir path
+from Dovecot LDA. Below step is used to fix it.
/etc/postfix/mysql/virtual_mailbox_maps.cf, update query =:# Part of file: mysql/virtual_mailbox_maps.cf
+
+# OLD SETTING
+#query = SELECT CONCAT(mailbox.storagenode, '/', mailbox.maildir) FROM ...
+
+# NEW SETTING
+query = SELECT CONCAT(mailbox.storagenode, '/', mailbox.maildir, '/Maildir/') FROM ...
+To make sure per-user BCC settings have higher priority than per-domain
+settings, please edit Postfix main config file main.cf, reverse the lookup
+maps in both sender_bcc_maps and recipient_bcc_maps.
* On Linux and OpenBSD, it's `/etc/postfix/main.cf`.
+* On FreeBSD, it's `/usr/local/etc/postfix/main.cf`.
+# Part of file: main.cf
+
+# OLD SETTINGS
+#recipient_bcc_maps = proxy:mysql:/etc/postfix/mysql/recipient_bcc_maps_domain.cf, proxy:mysql:/etc/postfix/mysql/recipient_bcc_maps_user.cf
+#sender_bcc_maps = proxy:mysql:/etc/postfix/mysql/sender_bcc_maps_domain.cf, proxy:mysql:/etc/postfix/mysql/sender_bcc_maps_user.cf
+
+# NEW SETTINGS
+recipient_bcc_maps = proxy:mysql:/etc/postfix/mysql/recipient_bcc_maps_user.cf, proxy:mysql:/etc/postfix/mysql/recipient_bcc_maps_domain.cf
+sender_bcc_maps = proxy:mysql:/etc/postfix/mysql/sender_bcc_maps_user.cf, proxy:mysql:/etc/postfix/mysql/sender_bcc_maps_domain.cf
+enablelib-storage=1Dovecot-2.x requires mailbox.enablelib-storage=1 for IMAP folder sharing.
+Below steps are used to add it for all mail users.
mailbox.enablelib-storage:# mysql -uroot -p
+sql> USE vmail;
+sql> ALTER TABLE mailbox ADD COLUMN `enablelib-storage` TINYINT(1) NOT NULL DEFAULT 1;
+sql> CREATE INDEX idx_mailbox_lib_storage ON mailbox (`enablelib-storage`);
+
+-- Add missing index
+sql> CREATE INDEX idx_mailbox_enabledoveadm ON mailbox (enabledoveadm);
+/etc/dovecot/dovecot-mysql.conf, add `` (not single quote) aroundenable%Ls%Lc`.# Part of file: dovecot-mysql.conf
+
+# OLD SETTING
+# AND mailbox.enable%Ls%Lc=1 \
+
+# NEW SETTING
+ AND mailbox.`enable%Ls%Lc`=1 \
+anyone_shares in MySQL database vmailIf you want to share IMAP folder to anyone, you have to create new SQL table
+anyone_shares in MySQL database vmail. Steps:
# mysql -uroot -p
+sql> USE vmail;
+sql> CREATE TABLE IF NOT EXISTS anyone_shares (
+ from_user VARCHAR(255) NOT NULL,
+ dummy CHAR(1) DEFAULT '1',
+ PRIMARY KEY (from_user)
+);
+language in table vmail.mailboxColumn mailbox.language is used to store short code of user preferred
+language used by iRedAdmin.
mailbox.language:# mysql -uroot -p
+sql> USE vmail;
+sql> ALTER TABLE mailbox ADD COLUMN language VARCHAR(5) NOT NULL DEFAULT 'en_US';
+iRedMail uses Dovecot LDA as transport by default, but if you use transport
+virtual, the Postfix built-in transport, it will use different maildir path
+from Dovecot LDA. Below step is used to fix it.
/etc/postfix/mysql/virtual_mailbox_maps.cf, update query =:# Part of file: mysql/virtual_mailbox_maps.cf
+
+# OLD SETTING
+#query = SELECT (mailbox.storagenode || '/' || mailbox.maildir) FROM ...
+
+# NEW SETTING
+query = SELECT CONCAT(mailbox.storagenode, '/', mailbox.maildir, '/Maildir/') FROM ...
+To make sure per-user BCC settings have higher priority than per-domain
+settings, please edit Postfix main config file main.cf, reverse the lookup
+maps in both sender_bcc_maps and recipient_bcc_maps.
* On Linux and OpenBSD, it's `/etc/postfix/main.cf`.
+* On FreeBSD, it's `/usr/local/etc/postfix/main.cf`.
+# Part of file: main.cf
+
+# OLD SETTINGS
+#recipient_bcc_maps = proxy:pgsql:/etc/postfix/pgsql/recipient_bcc_maps_domain.cf, proxy:pgsql:/etc/postfix/pgsql/recipient_bcc_maps_user.cf
+#sender_bcc_maps = proxy:pgsql:/etc/postfix/pgsql/sender_bcc_maps_domain.cf, proxy:pgsql:/etc/postfix/pgsql/sender_bcc_maps_user.cf
+
+# NEW SETTINGS
+recipient_bcc_maps = proxy:pgsql:/etc/postfix/pgsql/recipient_bcc_maps_user.cf, proxy:pgsql:/etc/postfix/pgsql/recipient_bcc_maps_domain.cf
+sender_bcc_maps = proxy:pgsql:/etc/postfix/pgsql/sender_bcc_maps_user.cf, proxy:pgsql:/etc/postfix/pgsql/sender_bcc_maps_domain.cf
+enablelib-storage=1Dovecot-2.x requires mailbox.enablelib-storage=1 for IMAP folder sharing.
+Below steps are used to add it for all mail users.
Please switch to PostgreSQL daemon user, and execute SQL commands to add
+ required column mailbox.enablelib-storage:
postgres.pgsql._postgresql.# su - postgres
+# psql -d vmail
+sql> ALTER TABLE mailbox ADD COLUMN "enablelib-storage" INT2 NOT NULL DEFAULT 1;
+sql> CREATE INDEX idx_mailbox_lib_storage ON mailbox ("enablelib-storage");
+
+-- Add missing index
+sql> CREATE INDEX idx_mailbox_enabledoveadm ON mailbox (enabledoveadm);
+
+sql> GRANT SELECT ON mailbox TO vmail;
+sql> GRANT SELECT,UPDATE,INSERT,DELETE ON mailbox to vmailadmin;
+/etc/dovecot/dovecot-pgsql.conf, add quotes for column mailbox.enable%Ls%Lc:# Part of file: dovecot-pgsql.conf
+
+# OLD SETTING
+# AND mailbox.enable%Ls%Lc=1 \
+
+# NEW SETTING
+ AND mailbox."enable%Ls%Lc"=1 \
+anyone_shares in PostgreSQL database vmailIf you want to share IMAP folder to anyone, you have to create new SQL table
+anyone_shares in PostgreSQL database vmail. Steps:
* On Linux, the daemon user of PostgreSQL is `postgres`.
+* On FreeBSD, the daemon user of PostgreSQL is `pgsql`.
+* On OpenBSD, the daemon user of PostgreSQL is `_postgresql`.
+# su - postgres
+# psql -d vmail
+sql> CREATE TABLE anyone_shares (
+ from_user VARCHAR(255) NOT NULL,
+ dummy CHAR(1),
+ PRIMARY KEY (from_user)
+);
+language in table vmail.mailboxColumn mailbox.language is used to store short code of user preferred
+language used by iRedAdmin.
Please switch to PostgreSQL daemon user, and execute SQL commands to add
+ required column mailbox.language:
postgres.pgsql._postgresql.# su - postgres
+# psql -d vmail
+sql> ALTER TABLE mailbox ADD COLUMN language VARCHAR(5) NOT NULL DEFAULT 'en_US';
+Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it. + + +