iredmail-doc/html/upgrade.iredmail.0.7.2-0.7....

102 lines
5.0 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Upgrade iRedMail from 0.7.2 to 0.7.3</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="/index.html" target="_blank">
<img alt="iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"
/>&nbsp;
<span>iRedMail</span>
</a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="upgrade-iredmail-from-072-to-073">Upgrade iRedMail from 0.7.2 to 0.7.3</h1>
<div class="toc">
<ul>
<li><a href="#upgrade-iredmail-from-072-to-073">Upgrade iRedMail from 0.7.2 to 0.7.3</a><ul>
<li><a href="#changelog">ChangeLog</a></li>
<li><a href="#general-all-backends-should-apply-these-upgrade-steps">General (All backends should apply these upgrade steps)</a></li>
<li><a href="#openldap-backend-special">OpenLDAP backend special</a><ul>
<li><a href="#add-enabledservicelda-required-by-dovecot-2x">Add enabledService=lda, required by Dovecot 2.x.</a></li>
</ul>
</li>
<li><a href="#mysql-backend-special">MySQL backend special</a></li>
</ul>
</li>
</ul>
</div>
<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>2011-08-23: Add upgrade tutorial or links for iRedAdmin (open source edition), phpMyAdmin, Roundcube.</li>
<li>2011-08-17: initial public.</li>
</ul>
<h2 id="general-all-backends-should-apply-these-upgrade-steps">General (All backends should apply these upgrade steps)</h2>
<ul>
<li>Please follow phpMyAdmin official tutorial to upgrade phpMyAdmin: http://www.phpmyadmin.net/documentation/#upgrading</li>
<li>Please follow Roundcube official tutorial to upgrade Roundcube Webmail: <a href="https://github.com/roundcube/roundcubemail/wiki/Upgrade">https://github.com/roundcube/roundcubemail/wiki/Upgrade</a></li>
</ul>
<h2 id="openldap-backend-special">OpenLDAP backend special</h2>
<h3 id="add-enabledservicelda-required-by-dovecot-2x">Add <code>enabledService=lda</code>, required by Dovecot 2.x.</h3>
<p><strong>Note</strong>: If you're running dovecot-1.1.x, or 1.2.x, then please stay on that
version, but it's still recommended to add this missing value for existing
users. It won't impact current mail services.</p>
<p><strong>Note</strong>: Dovecot-2.x is the default version on RHEL/CentOS/Scieitnfic Linux 6.x.</p>
<p>Dovecot-2.x requires <code>enabledService=enablelda</code> for receiving email for virtual
mail users, so we should add it if users doesn't have it.</p>
<ul>
<li>Download python script used to adding missing values.</li>
</ul>
<pre><code># cd /root/
# wget http://iredmail.googlecode.com/hg/extra/update/updateLDAPValues_072_to_073.py
</code></pre>
<ul>
<li>Open <code>updateLDAPValues_072_to_073.py</code>, config LDAP server related settings in file head. e.g.</li>
</ul>
<pre><code># Part of file: updateLDAPValues_072_to_073.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'
</code></pre>
<p>You can find required LDAP credential in iRedAdmin config file or <code>iRedMail.tips</code>
file under your iRedMail installation directory. Using either
<code>cn=Manager,dc=xx,dc=xx</code> or <code>cn=vmailadmin,dc=xx,dc=xx</code> as bind dn is ok.</p>
<ul>
<li>Execute this script, it will add missing values for mail accounts:</li>
</ul>
<pre><code># python updateLDAPValues_072_to_073.py
</code></pre>
<h2 id="mysql-backend-special">MySQL backend special</h2>
<ul>
<li>Add new column: <code>mailbox.enablelda</code>, required by Dovecot 2.x, used to replace
<code>mailbox.enabledeliver</code>.</li>
</ul>
<pre><code>$ mysql -uroot -p
mysql&gt; USE vmail;
mysql&gt; ALTER TABLE mailbox ADD COLUMN enablelda TINYINT(1) NOT NULL DEFAULT 1;
mysql&gt; ALTER TABLE mailbox ADD INDEX enablelda (enablelda);
</code></pre><div class="footer">
<p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://bitbucket.org/zhb/iredmail-docs/get/tip.tar.bz2">download the latest version</a> for offline reading. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div>
<script type="text/javascript">
(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>