New: upgrade/0-upgrade.iredmail.0.8.2-0.8.3.md.

This commit is contained in:
Zhang Huangbin 2014-12-06 19:31:32 +08:00
parent 4983a04570
commit e8d7ed7ae2
4 changed files with 322 additions and 2 deletions

View File

@ -25,7 +25,7 @@ there's an alternative solution: <a href="./migrate.to.new.iredmail.server.html"
<li><a href="http://www.iredmail.org/forum/topic5831-iredmail086-has-been-released.html">0.8.6</a>, Dec 16, 2013. <a href="./upgrade.iredmail.0.8.5-0.8.6.html">Upgrade from iRedMail-0.8.5</a></li>
<li><a href="http://www.iredmail.org/forum/topic5167-news-announcements-bug-fixes-iredmail085-has-been-released.html">0.8.5</a>, Jul 16, 2013. <a href="./upgrade.iredmail.0.8.4-0.8.5.html">Upgrade from iRedMail-0.8.4</a></li>
<li><a href="http://www.iredmail.org/forum/topic4646-news-announcements-bug-fixes-iredmail084-has-been-released.html">0.8.4</a>, Mar 26, 2013. <a href="./upgrade.iredmail.0.8.3-0.8.4.html">Upgrade from iRedMail-0.8.3</a></li>
<li><a href="http://www.iredmail.org/forum/topic4016-news-announcements-bug-fixes-iredmail083-has-been-released.html">0.8.3</a>, Oct 13, 2012. <a href="http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.8.2-0.8.3">Upgrade from iRedMail-0.8.2</a></li>
<li><a href="http://www.iredmail.org/forum/topic4016-news-announcements-bug-fixes-iredmail083-has-been-released.html">0.8.3</a>, Oct 13, 2012. <a href="./upgrade.iredmail.0.8.2-0.8.3.html">Upgrade from iRedMail-0.8.2</a></li>
<li><a href="http://www.iredmail.org/forum/topic3913-news-announcements-bug-fixes-iredmail082-has-been-released.html">0.8.2</a>, Sep 19, 2012. <a href="http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.8.1-0.8.2">Upgrade from iRedMail-0.8.1</a></li>
<li><a href="http://www.iredmail.org/forum/topic3499-news-announcements-bug-fixes-iredmail081-has-been-released.html">0.8.1</a>, Jun 8, 2012. <a href="http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.8.0-0.8.1">Upgrade from iRedMail-0.8.0</a></li>
<li><a href="http://www.iredmail.org/forum/topic3345.html">0.8.0</a>, May 10, 2012. <a href="http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.7.4-0.8.0">Upgrade from iRedMail-0.7.4</a></li>

View File

@ -0,0 +1,178 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Upgrade iRedMail from 0.8.2 to 0.8.3</title>
<link href="./css/markdown.css" rel="stylesheet"></head>
</head>
<body>
<div id="navigation">
<a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
// <a href="./index.html">Document Index</a>
</div><h1 id="upgrade-iredmail-from-082-to-083">Upgrade iRedMail from 0.8.2 to 0.8.3</h1>
<div class="toc">
<ul>
<li><a href="#upgrade-iredmail-from-082-to-083">Upgrade iRedMail from 0.8.2 to 0.8.3</a><ul>
<li><a href="#changelog">ChangeLog</a></li>
<li><a href="#general-all-backends-should-apply-these-steps">General (All backends should apply these steps)</a><ul>
<li><a href="#update-etciredmail-release-with-iredmail-version-number">Update /etc/iredmail-release with iRedMail version number</a></li>
<li><a href="#upgrade-roundcube-webmail-to-the-latest-stable-release">Upgrade Roundcube webmail to the latest stable release</a></li>
<li><a href="#upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release">Upgrade iRedAPD (Postfix policy server) to the latest stable release</a></li>
<li><a href="#upgrade-iredadmin-open-source-edition-to-the-latest-stable-release">Upgrade iRedAdmin (open source edition) to the latest stable release</a></li>
</ul>
</li>
<li><a href="#fix-incorrect-path-in-cron-job">Fix incorrect path in cron job</a><ul>
<li><a href="#optional-notify-postmaster-if-users-mailbox-is-larger-than-or-equal-to-95-full">[Optional] Notify postmaster@ if user's mailbox is larger than or equal to 95% full</a></li>
</ul>
</li>
<li><a href="#openldap-backend-special">OpenLDAP backend special</a><ul>
<li><a href="#fix-incorrect-ldap-uri-in-cluebringer-config-file">Fix incorrect LDAP URI in Cluebringer config file</a></li>
</ul>
</li>
<li><a href="#mysql-backend-special">MySQL backend special</a><ul>
<li><a href="#fix-incorrect-sql-table-name-in-etcapache2confdcluebringerconf">Fix incorrect SQL table name in /etc/apache2/conf.d/cluebringer.conf</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<h2 id="changelog">ChangeLog</h2>
<ul>
<li>2012-10-16: [ldap] Fix incorrect LDAP URI in Cluebringer config file.</li>
<li>2012-10-16: [Optional] Send an email to postmaster@ if user's mailbox is larger than or equal to 95% full.</li>
<li>2012-10-10: Upgrade iRedAdmin (open source edition).</li>
<li>2012-10-10: [RHEL/CentOS/Scientific 6 only] Fix incorrect path in cron job.</li>
<li>2012-10-10: [Debian/Ubuntu only] Fix incorrect SQL table name in /etc/apache2/conf.d/cluebringer.conf</li>
</ul>
<h2 id="general-all-backends-should-apply-these-steps">General (All backends should apply these steps)</h2>
<h3 id="update-etciredmail-release-with-iredmail-version-number">Update /etc/iredmail-release with iRedMail version number</h3>
<p>iRedMail stores the release version in <code>/etc/iredmail-release</code> 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:</p>
<pre><code># File: /etc/iredmail-release
0.8.3
</code></pre>
<h3 id="upgrade-roundcube-webmail-to-the-latest-stable-release">Upgrade Roundcube webmail to the latest stable release</h3>
<p>Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
latest stable release immediately: <a href="http://trac.roundcube.net/wiki/Howto_Upgrade">How to upgrade Roundcube</a></p>
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-stable-release">Upgrade iRedAPD (Postfix policy server) to the latest stable release</h3>
<p>Please follow below tutorial to upgrade iRedAPD to the latest stable release:
<a href="http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Upgrade.iRedAPD">How to upgrade iRedAPD-1.4.1 or later versions to the latest stable release</a></p>
<h3 id="upgrade-iredadmin-open-source-edition-to-the-latest-stable-release">Upgrade iRedAdmin (open source edition) to the latest stable release</h3>
<p>Please follow this tutorial to upgrade iRedAdmin open source edition to the
latest stable release: <a href="./migrate.or.upgrade.iredadmin.html">Upgrade iRedAdmin to the latest stable release</a></p>
<h2 id="fix-incorrect-path-in-cron-job">Fix incorrect path in cron job</h2>
<p><strong>Note</strong>: 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.</p>
<p>iRedMail uses incorrect path (<code>/</code>) in user <code>amavis</code>'s cron job, please change
it to <code>/var/spool/amavisd/quarantine/</code> instead. Steps:</p>
<ul>
<li>Execute command <code>crontab</code> like below to edit user amavis's cron job:</li>
</ul>
<pre><code># crontab -e -u amavis
</code></pre>
<ul>
<li>Find below line:</li>
</ul>
<pre><code># Delete virus mails which created 15 days ago.
1 5 * * * find / -ctime +15 | xargs rm -rf {}
</code></pre>
<ul>
<li>Change the path <code>/</code> to <code>/var/spool/amavisd/quarantine/</code> like below:</li>
</ul>
<pre><code>1 5 * * * find /var/spool/amavisd/quarantine/ -ctime +15 | xargs rm -rf {}
</code></pre>
<ul>
<li>Save your changes and exit editor.</li>
</ul>
<h3 id="optional-notify-postmaster-if-users-mailbox-is-larger-than-or-equal-to-95-full">[Optional] Notify postmaster@ if user's mailbox is larger than or equal to 95% full</h3>
<p><strong>Note</strong>: This update is optional but strongly recommended, so that you, mail
server administrator, can deal with mailbox quota exceed issue in time.</p>
<ul>
<li>Append below text into <code>/usr/local/bin/dovecot-quota-warning.sh</code>:</li>
</ul>
<pre><code># Send a copy to postmaster@ if mailbox is greater than or equal to 95% full.
if [ ${PERCENT} -ge 95 ]; then
DOMAIN=&quot;$(echo ${USER} | awk -F'@' '{print $2}')&quot;
cat &lt;&lt; EOF | PH_DOVECOT_DELIVER -d postmaster@${DOMAIN} -o &quot;plugin/quota=dict:User quota::noenforcing:proxy::quota&quot;
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
</code></pre>
<ul>
<li>
<p>Replace <code>PH_DOVECOT_DELIVER</code> above by the real path of Dovecot deliver
program, you can find the path in the same file: <code>/usr/local/bin/dovecot-quota-warning.sh</code>.</p>
<ul>
<li>On RHEL/CentOS/Scientific Linux/Gentoo, it's <code>/usr/libexec/dovecot/deliver</code>.</li>
<li>On Debian/Ubuntu/openSUSE, it's <code>/usr/lib/dovecot/deliver</code>.</li>
<li>On FreeBSD/OpenBSD, it's <code>/usr/local/libexec/dovecot/deliver</code>.</li>
</ul>
</li>
<li>
<p>Replace 'PH_HOSTNAME' above by your server hostname. You can get it with below command:</p>
</li>
</ul>
<pre><code># hostname --fqdn
</code></pre>
<h2 id="openldap-backend-special">OpenLDAP backend special</h2>
<h3 id="fix-incorrect-ldap-uri-in-cluebringer-config-file">Fix incorrect LDAP URI in Cluebringer config file</h3>
<p>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.</p>
<ul>
<li>
<p>Open Apache config file of Cluebringer</p>
<ul>
<li>on RHEL/CentOS/Scientific Linux 6, it's <code>/etc/httpd/conf.d/cluebringer.conf</code>.</li>
<li>on Debian 7 (wheezy), or Ubuntu 11.10 or later releases, it's <code>/etc/apache2/conf.d/cluebringer.conf</code>.</li>
<li>on FreeBSD, it's <code>/usr/local/etc/apache22/Includes/cluebringer.conf</code>.</li>
</ul>
</li>
<li>
<p>Find parameter <code>AuthLDAPUrl</code> and update it:</p>
<ul>
<li>replace <code>o=domainAdmins</code> by <code>o=domains</code></li>
<li>replace <code>objectclass=mailAdmin</code> by <code>objectclass=mailUser</code></li>
</ul>
</li>
<li>
<p>Save changes and restarting Apache web server.</p>
</li>
</ul>
<h2 id="mysql-backend-special">MySQL backend special</h2>
<h3 id="fix-incorrect-sql-table-name-in-etcapache2confdcluebringerconf">Fix incorrect SQL table name in <code>/etc/apache2/conf.d/cluebringer.conf</code></h3>
<p><strong>Note</strong>: This is applicable to Debian and Ubuntu only.</p>
<p>iRedMail uses incorrect SQL table name <code>admin</code> in
<code>/etc/apache2/conf.d/cluebringer.conf</code>, please change it to <code>mailbox</code> like below:</p>
<pre><code># Part of file: /etc/apache2/conf.d/cluebringer.conf
AuthMySQL_Password_Table mailbox
</code></pre>
<p>Restarting Apache service is required.</p><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-3293801-14");
pageTracker._trackPageview();
} catch(err) {}
</script>
</body></html>

View File

@ -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.

View File

@ -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)