From e8d7ed7ae2d086ca7560be5bd3221e028187721c Mon Sep 17 00:00:00 2001 From: Zhang Huangbin Date: Sat, 6 Dec 2014 19:31:32 +0800 Subject: [PATCH] New: upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md. --- html/iredmail.releases.html | 2 +- html/upgrade.iredmail.0.8.2-0.8.3.html | 178 ++++++++++++++++++++++ upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md | 142 +++++++++++++++++ upgrade/1-iredmail.releases.md | 2 +- 4 files changed, 322 insertions(+), 2 deletions(-) create mode 100644 html/upgrade.iredmail.0.8.2-0.8.3.html create mode 100644 upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md diff --git a/html/iredmail.releases.html b/html/iredmail.releases.html index d5217cca..3ca32dd2 100644 --- a/html/iredmail.releases.html +++ b/html/iredmail.releases.html @@ -25,7 +25,7 @@ there's an alternative solution: 0.8.6, Dec 16, 2013. Upgrade from iRedMail-0.8.5
  • 0.8.5, Jul 16, 2013. Upgrade from iRedMail-0.8.4
  • 0.8.4, Mar 26, 2013. Upgrade from iRedMail-0.8.3
    • -
  • 0.8.3, Oct 13, 2012. Upgrade from iRedMail-0.8.2
    • +
  • 0.8.3, Oct 13, 2012. Upgrade from iRedMail-0.8.2
  • 0.8.2, Sep 19, 2012. Upgrade from iRedMail-0.8.1
  • 0.8.1, Jun 8, 2012. Upgrade from iRedMail-0.8.0
  • 0.8.0, May 10, 2012. Upgrade from iRedMail-0.7.4
    • diff --git a/html/upgrade.iredmail.0.8.2-0.8.3.html b/html/upgrade.iredmail.0.8.2-0.8.3.html new file mode 100644 index 00000000..598bfde7 --- /dev/null +++ b/html/upgrade.iredmail.0.8.2-0.8.3.html @@ -0,0 +1,178 @@ + + + + Upgrade iRedMail from 0.8.2 to 0.8.3 + + + + +

    Upgrade iRedMail from 0.8.2 to 0.8.3

    +
    + +
    +

    ChangeLog

    + +

    General (All backends should 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.3
+
    + +

    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: +How to upgrade iRedAPD-1.4.1 or later versions 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

    +

    Fix incorrect path in cron job

    +

    Note: This is applicable to Red Hat Enterprise Linux 6, CentOS 6, +Scientific Linux 6. If you're running other distributions or releases, please +skip this step.

    +

    iRedMail uses incorrect path (/) in user amavis's cron job, please change +it to /var/spool/amavisd/quarantine/ instead. Steps:

    + +
    # crontab -e -u amavis
+
    + + +
    # Delete virus mails which created 15 days ago.
+1   5   *   *   *   find / -ctime +15 | xargs rm -rf {}
+
    + + +
    1   5   *   *   *   find /var/spool/amavisd/quarantine/ -ctime +15 | xargs rm -rf {}
+
    + + +

    [Optional] Notify postmaster@ if user's mailbox is larger than or equal to 95% full

    +

    Note: This update is optional but strongly recommended, so that you, mail +server administrator, can deal with mailbox quota exceed issue in time.

    + +
    # Send a copy to postmaster@ if mailbox is greater than or equal to 95% full.
+if [ ${PERCENT} -ge 95 ]; then
+    DOMAIN="$(echo ${USER} | awk -F'@' '{print $2}')"
+    cat << EOF | PH_DOVECOT_DELIVER -d postmaster@${DOMAIN} -o "plugin/quota=dict:User quota::noenforcing:proxy::quota"
+From: no-reply@PH_HOSTNAME
+Subject: Mailbox Quota Warning: ${PERCENT}% full, ${USER}
+
+Your mailbox is now ${PERCENT}% full, please clean up some mails for
+further incoming mails.
+EOF
+fi
+
    + + +
    # hostname --fqdn
+
    + +

    OpenLDAP backend special

    +

    Fix incorrect LDAP URI in Cluebringer config file

    +

    Note: This step is applicable if you have Cluebringer installed, which means +you're running PostgreSQL backend, or running Debian 7 (wheezy), Ubuntu 11.10 +and later releases.

    + +

    MySQL backend special

    +

    Fix incorrect SQL table name in /etc/apache2/conf.d/cluebringer.conf

    +

    Note: This is applicable to Debian and Ubuntu only.

    +

    iRedMail uses incorrect SQL table name admin in +/etc/apache2/conf.d/cluebringer.conf, please change it to mailbox like below:

    +
    # Part of file: /etc/apache2/conf.d/cluebringer.conf
+
+    AuthMySQL_Password_Table mailbox
+
    + +

    Restarting Apache service is required.

    Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it. + + + \ No newline at end of file diff --git a/upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md b/upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md new file mode 100644 index 00000000..c348a289 --- /dev/null +++ b/upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md @@ -0,0 +1,142 @@ +# Upgrade iRedMail from 0.8.2 to 0.8.3 + +[TOC] + +## ChangeLog + +* 2012-10-16: [ldap] Fix incorrect LDAP URI in Cluebringer config file. +* 2012-10-16: [Optional] Send an email to postmaster@ if user's mailbox is larger than or equal to 95% full. +* 2012-10-10: Upgrade iRedAdmin (open source edition). +* 2012-10-10: [RHEL/CentOS/Scientific 6 only] Fix incorrect path in cron job. +* 2012-10-10: [Debian/Ubuntu only] Fix incorrect SQL table name in /etc/apache2/conf.d/cluebringer.conf + +## General (All backends should 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.3 +``` + +### 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](http://trac.roundcube.net/wiki/Howto_Upgrade) + +### Upgrade iRedAPD (Postfix policy server) to the latest stable release + +Please follow below tutorial to upgrade iRedAPD to the latest stable release: +[How to upgrade iRedAPD-1.4.1 or later versions to the latest stable release](http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Upgrade.iRedAPD) + +### 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](./migrate.or.upgrade.iredadmin.html) + +## Fix incorrect path in cron job + +__Note__: This is applicable to Red Hat Enterprise Linux 6, CentOS 6, +Scientific Linux 6. If you're running other distributions or releases, please +skip this step. + +iRedMail uses incorrect path (`/`) in user `amavis`'s cron job, please change +it to `/var/spool/amavisd/quarantine/` instead. Steps: + +* Execute command `crontab` like below to edit user amavis's cron job: + +``` +# crontab -e -u amavis +``` + +* Find below line: + +``` +# Delete virus mails which created 15 days ago. +1 5 * * * find / -ctime +15 | xargs rm -rf {} +``` + +* Change the path `/` to `/var/spool/amavisd/quarantine/` like below: + +``` +1 5 * * * find /var/spool/amavisd/quarantine/ -ctime +15 | xargs rm -rf {} +``` + +* Save your changes and exit editor. + +### [Optional] Notify postmaster@ if user's mailbox is larger than or equal to 95% full + +__Note__: This update is optional but strongly recommended, so that you, mail +server administrator, can deal with mailbox quota exceed issue in time. + +* Append below text into `/usr/local/bin/dovecot-quota-warning.sh`: + +``` +# Send a copy to postmaster@ if mailbox is greater than or equal to 95% full. +if [ ${PERCENT} -ge 95 ]; then + DOMAIN="$(echo ${USER} | awk -F'@' '{print $2}')" + cat << EOF | PH_DOVECOT_DELIVER -d postmaster@${DOMAIN} -o "plugin/quota=dict:User quota::noenforcing:proxy::quota" +From: no-reply@PH_HOSTNAME +Subject: Mailbox Quota Warning: ${PERCENT}% full, ${USER} + +Your mailbox is now ${PERCENT}% full, please clean up some mails for +further incoming mails. +EOF +fi +``` + +* Replace `PH_DOVECOT_DELIVER` above by the real path of Dovecot deliver + program, you can find the path in the same file: `/usr/local/bin/dovecot-quota-warning.sh`. + + * On RHEL/CentOS/Scientific Linux/Gentoo, it's `/usr/libexec/dovecot/deliver`. + * On Debian/Ubuntu/openSUSE, it's `/usr/lib/dovecot/deliver`. + * On FreeBSD/OpenBSD, it's `/usr/local/libexec/dovecot/deliver`. + +* Replace 'PH_HOSTNAME' above by your server hostname. You can get it with below command: + +``` +# hostname --fqdn +``` + +## OpenLDAP backend special + +### Fix incorrect LDAP URI in Cluebringer config file + +Note: This step is applicable if you have Cluebringer installed, which means +you're running PostgreSQL backend, or running Debian 7 (wheezy), Ubuntu 11.10 +and later releases. + +* Open Apache config file of Cluebringer + + * on RHEL/CentOS/Scientific Linux 6, it's `/etc/httpd/conf.d/cluebringer.conf`. + * on Debian 7 (wheezy), or Ubuntu 11.10 or later releases, it's `/etc/apache2/conf.d/cluebringer.conf`. + * on FreeBSD, it's `/usr/local/etc/apache22/Includes/cluebringer.conf`. + +* Find parameter `AuthLDAPUrl` and update it: + + * replace `o=domainAdmins` by `o=domains` + * replace `objectclass=mailAdmin` by `objectclass=mailUser` + +* Save changes and restarting Apache web server. + +## MySQL backend special + +### Fix incorrect SQL table name in `/etc/apache2/conf.d/cluebringer.conf` + +__Note__: This is applicable to Debian and Ubuntu only. + +iRedMail uses incorrect SQL table name `admin` in +`/etc/apache2/conf.d/cluebringer.conf`, please change it to `mailbox` like below: + +``` +# Part of file: /etc/apache2/conf.d/cluebringer.conf + + AuthMySQL_Password_Table mailbox +``` + +Restarting Apache service is required. diff --git a/upgrade/1-iredmail.releases.md b/upgrade/1-iredmail.releases.md index 2685ba43..57454e0d 100644 --- a/upgrade/1-iredmail.releases.md +++ b/upgrade/1-iredmail.releases.md @@ -18,7 +18,7 @@ You can always download the latest iRedMail release on [Download page](../downlo * [0.8.6](http://www.iredmail.org/forum/topic5831-iredmail086-has-been-released.html), Dec 16, 2013. [Upgrade from iRedMail-0.8.5](./upgrade.iredmail.0.8.5-0.8.6.html) * [0.8.5](http://www.iredmail.org/forum/topic5167-news-announcements-bug-fixes-iredmail085-has-been-released.html), Jul 16, 2013. [Upgrade from iRedMail-0.8.4](./upgrade.iredmail.0.8.4-0.8.5.html) * [0.8.4](http://www.iredmail.org/forum/topic4646-news-announcements-bug-fixes-iredmail084-has-been-released.html), Mar 26, 2013. [Upgrade from iRedMail-0.8.3](./upgrade.iredmail.0.8.3-0.8.4.html) -* [0.8.3](http://www.iredmail.org/forum/topic4016-news-announcements-bug-fixes-iredmail083-has-been-released.html), Oct 13, 2012. [Upgrade from iRedMail-0.8.2](http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.8.2-0.8.3) +* [0.8.3](http://www.iredmail.org/forum/topic4016-news-announcements-bug-fixes-iredmail083-has-been-released.html), Oct 13, 2012. [Upgrade from iRedMail-0.8.2](./upgrade.iredmail.0.8.2-0.8.3.html) * [0.8.2](http://www.iredmail.org/forum/topic3913-news-announcements-bug-fixes-iredmail082-has-been-released.html), Sep 19, 2012. [Upgrade from iRedMail-0.8.1](http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.8.1-0.8.2) * [0.8.1](http://www.iredmail.org/forum/topic3499-news-announcements-bug-fixes-iredmail081-has-been-released.html), Jun 8, 2012. [Upgrade from iRedMail-0.8.0](http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.8.0-0.8.1) * [0.8.0](http://www.iredmail.org/forum/topic3345.html), May 10, 2012. [Upgrade from iRedMail-0.7.4](http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.7.4-0.8.0)