177 lines
8.9 KiB
HTML
177 lines
8.9 KiB
HTML
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>Upgrade iRedMail from 0.9.2 to 0.9.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-092-to-093">Upgrade iRedMail from 0.9.2 to 0.9.3</h1>
|
|
<div class="toc">
|
|
<ul>
|
|
<li><a href="#upgrade-iredmail-from-092-to-093">Upgrade iRedMail from 0.9.2 to 0.9.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-new-iredmail-version-number">Update /etc/iredmail-release with new iRedMail version number</a></li>
|
|
<li><a href="#upgrade-iredapd-postfix-policy-server-to-the-latest-170">Upgrade iRedAPD (Postfix policy server) to the latest 1.7.0</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="#todo-amavisd-fix-incorrect-setting-which-signs-dkim-on-inbound-messages">[TODO] Amavisd: Fix incorrect setting which signs DKIM on inbound messages</a></li>
|
|
<li><a href="#dovecot-fix-incorrect-quota-warning-priorities">Dovecot: Fix incorrect quota warning priorities</a></li>
|
|
<li><a href="#dovecot-22-add-more-special-folders-as-alias-folders">Dovecot-2.2: Add more special folders as alias folders</a></li>
|
|
<li><a href="#optional-fixed-not-preserve-the-case-of-extension-while-delivering-message-to-mailbox">[OPTIONAL] Fixed: Not preserve the case of ${extension} while delivering message to mailbox</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<p><strong>This is still a DRAFT document, do NOT apply it.</strong></p>
|
|
<h2 id="changelog">ChangeLog</h2>
|
|
<blockquote>
|
|
<p>We provide remote upgrade service, check <a href="../support.html">the price</a> and <a href="../contact.html">contact us</a>.</p>
|
|
</blockquote>
|
|
<ul>
|
|
<li>2015-07-03: Dovecot: Fix incorrect quota warning priorities</li>
|
|
<li>2015-06-30: Dovecot-2.2: Add more special folders as alias folders.</li>
|
|
<li>2015-06-09: [OPTIONAL] Fixed: Not preserve the case of <code>${extension}</code> while delivering message to mailbox.</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-new-iredmail-version-number">Update <code>/etc/iredmail-release</code> with new 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.9.3
|
|
</code></pre>
|
|
|
|
<h3 id="upgrade-iredapd-postfix-policy-server-to-the-latest-170">Upgrade iRedAPD (Postfix policy server) to the latest 1.7.0</h3>
|
|
<p>Please follow below tutorial to upgrade iRedAPD to the latest stable release:
|
|
<a href="./upgrade.iredapd.html">How to upgrade iRedAPD-1.4.0 or later versions to the latest stable release</a></p>
|
|
<p>Detailed release notes are available here: <a href="./iredapd.releases.html">iRedAPD release notes</a>.</p>
|
|
<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="todo-amavisd-fix-incorrect-setting-which-signs-dkim-on-inbound-messages">[TODO] Amavisd: Fix incorrect setting which signs DKIM on inbound messages</h3>
|
|
<ul>
|
|
<li>Add <code>$interface_policy{'10026'} = 'ORIGINATING';</code> in amavisd.conf</li>
|
|
<li>Remove '$originating = 1;'</li>
|
|
<li>Update transport <code>submission</code> in <code>/etc/postfix/master.cf</code> to use
|
|
<code>content_filter=smtp-amavis:[127.0.0.1]:10026</code> as content filter.</li>
|
|
</ul>
|
|
<p>With these changes, Amavisd will aply policy bank 'ORIGINATING' to emails
|
|
submitted through port 587 by smtp authenticated user. This way we clearly
|
|
separate emails submitted by smtp authenticated users and inbound message sent
|
|
by others, and Amavisd won't sign DKIM on inbound message anymore.</p>
|
|
<h3 id="dovecot-fix-incorrect-quota-warning-priorities">Dovecot: Fix incorrect quota warning priorities</h3>
|
|
<p>iRedMail configures Dovecot to send warning message to local user when the
|
|
mailbox quota is 85%, 90% or 95% full, but the priorities is wrong. Please
|
|
fix it with steps below.</p>
|
|
<ul>
|
|
<li>Find below setting in Dovecot config file <code>/etc/dovecot/dovecot.conf</code>
|
|
(Linux/OpenBSD) or <code>/usr/local/etc/dovecot/dovecot.conf</code> (FreeBSD):</li>
|
|
</ul>
|
|
<pre><code> quota_warning = storage=85%% quota-warning 85 %u
|
|
quota_warning2 = storage=90%% quota-warning 90 %u
|
|
quota_warning3 = storage=95%% quota-warning 95 %u
|
|
</code></pre>
|
|
|
|
<p><code>quota_warning</code> has the highest priority, <code>quota_warning3</code> has the lowest
|
|
priority. Only the command for the first exceeded limit is executed, so we must
|
|
configure the highest limit first.</p>
|
|
<p>With above setting, when the mailbox quota goes from 70% to 98% directly, it
|
|
sends warning message to notify user that the quota is 85% full, this is wrong,
|
|
it's expected to be warned as 95% full instead.</p>
|
|
<ul>
|
|
<li>Update them to below ones to fix it. Please pay close attention to the percent
|
|
numbers:</li>
|
|
</ul>
|
|
<pre><code> quota_warning = storage=95%% quota-warning 95 %u
|
|
quota_warning2 = storage=90%% quota-warning 90 %u
|
|
quota_warning3 = storage=85%% quota-warning 85 %u
|
|
</code></pre>
|
|
|
|
<p>Restart Dovecot service is required.</p>
|
|
<p>For more details, please read Dovecot document:
|
|
<a href="http://wiki2.dovecot.org/Quota/Configuration">Quota Configuration</a></p>
|
|
<h3 id="dovecot-22-add-more-special-folders-as-alias-folders">Dovecot-2.2: Add more special folders as alias folders</h3>
|
|
<p>Note: This is applicable to Dovecot-2.2.x. if you're running Dovecot-2.1.x or
|
|
earlier versions, please skip this step.</p>
|
|
<p>Check Dovecot version number with below command first:</p>
|
|
<pre><code class="bash"># dovecot --version
|
|
</code></pre>
|
|
|
|
<p>Open Dovecot config file <code>/etc/dovecot/dovecot.conf</code> (Linux/OpenBSD) or
|
|
<code>/usr/local/etc/dovecot/dovecot.conf</code> (FreeBSD), find below setting:</p>
|
|
<pre><code>namespace {
|
|
type = private
|
|
...
|
|
inbox = yes
|
|
...
|
|
}
|
|
</code></pre>
|
|
|
|
<p>Add below alias folders inside the same <code>namespace {}</code> block:</p>
|
|
<pre><code> mailbox "Sent Items" {
|
|
auto = no
|
|
special_use = \Sent
|
|
}
|
|
|
|
mailbox "Deleted Messages" {
|
|
auto = no
|
|
special_use = \Trash
|
|
}
|
|
|
|
mailbox "Deleted Messages" {
|
|
auto = no
|
|
special_use = \Trash
|
|
}
|
|
|
|
# Archive
|
|
mailbox Archive {
|
|
auto = subscribe
|
|
special_use = \Archive
|
|
}
|
|
mailbox Archives {
|
|
auto = no
|
|
special_use = \Archive
|
|
}
|
|
</code></pre>
|
|
|
|
<p>Restart Dovecot service is required.</p>
|
|
<h3 id="optional-fixed-not-preserve-the-case-of-extension-while-delivering-message-to-mailbox">[OPTIONAL] Fixed: Not preserve the case of <code>${extension}</code> while delivering message to mailbox</h3>
|
|
<p>With iRedMail-0.9.2 and earlier releases, email sent to user
|
|
<code>username+Ext@domain.com</code> (upper case <code>E</code>) will be delivered to folder
|
|
<code>ext</code> (lower case <code>e</code>) of <code>username@domain.com</code>'s mailbox. This fix will
|
|
preserve the case of address extension.</p>
|
|
<ul>
|
|
<li>Open file <code>/etc/postfix/master.cf</code> (Linux/OpenBSD) or
|
|
<code>/usr/local/etc/postfix/master.cf</code> (FreeBSD), find below lines:</li>
|
|
</ul>
|
|
<pre><code># Use dovecot deliver program as LDA.
|
|
dovecot unix - n n - - pipe
|
|
flags=DRhu ...
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Replace <code>flags=DRhu</code> by <code>flags=DRh</code> (remove <code>u</code>) in the third line:</li>
|
|
</ul>
|
|
<pre><code> flags=DRh ...
|
|
</code></pre>
|
|
|
|
<ul>
|
|
<li>Save your change and restart Postfix service.</li>
|
|
</ul><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.<script>
|
|
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
|
|
|
ga('create', 'UA-3293801-21', 'auto');
|
|
ga('send', 'pageview');
|
|
</script>
|
|
</body></html> |