iredmail-doc/html/migrate.or.upgrade.iredadmi...

125 lines
5.8 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Migrate or upgrade iRedAdmin</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="migrate-or-upgrade-iredadmin">Migrate or upgrade iRedAdmin</h1>
<div class="toc">
<ul>
<li><a href="#migrate-or-upgrade-iredadmin">Migrate or upgrade iRedAdmin</a><ul>
<li><a href="#requirements">Requirements</a></li>
<li><a href="#download-the-latest-iredadmin">Download the latest iRedAdmin</a></li>
<li><a href="#upgrade-steps">Upgrade Steps</a></li>
<li><a href="#additional-steps">Additional steps</a></li>
</ul>
</li>
</ul>
</div>
<div class="admonition note">
<p class="admonition-title">Paid Remote Upgrade Support</p>
<p>We offer remote upgrade support if you don't want to get your hands dirty,
check <a href="../support.html">the details</a> and <a href="../contact.html">contact us</a>.</p>
</div>
<p>This tutorial describes how to update or migrate iRedAdmin (either open source
edition or old iRedAdmin-Pro release) to the latest iRedAdmin release (again,
either open source edition or iRedAdmin-Pro).</p>
<h2 id="requirements">Requirements</h2>
<ol>
<li>
<p>The latest iRedAdmin-Pro always requires the latest iRedMail stable release,
so you <strong>MUST</strong> upgrade iRedMail to the latest stable release before
upgrading iRedAdmin-Pro.</p>
<ul>
<li>
<p>If you run the latest iRedAdmin-Pro with old iRedMail release, you may
get error due to missing some required ldap attribute/value pairs
(OpenLDAP backend), or missing some required SQL columns.</p>
</li>
<li>
<p>If you run the latest iRedMail with old iRedAdmin-Pro, you may get error
due to missing dropped SQL columns, or created accounts may miss some
properties required by the latest iRedMail.</p>
</li>
</ul>
</li>
<li>
<p>You <strong>MUST</strong> have iRedAdmin open source edition or old iRedAdmin-Pro release
installed and running on your server before upgrading.</p>
</li>
</ol>
<h2 id="download-the-latest-iredadmin">Download the latest iRedAdmin</h2>
<ul>
<li>iRedAdmin open source edition is available for download <a href="http://www.iredmail.org/yum/misc/">here</a>.</li>
<li>
<p>iRedAdmin-Pro customers can get download link of new release by following
steps below:</p>
<ul>
<li>Login to iRedAdmin-Pro as global admin.</li>
<li>Click <code>License</code> button on the top-right corner. it will show you basic
license info and a <code>Download</code> button if new version is available.</li>
<li>Click <code>Download</code> button, your mailbox (license owner) will receive an email
with download link in a short time. Note: if your mail server has greylisting
enabled, it may take longer, please be patient and don't request download
link again and again.</li>
</ul>
<p>If you cannot download iRedAdmin-Pro for some reason, please <a href="../contact.html">contact us</a>.</p>
</li>
</ul>
<h2 id="upgrade-steps">Upgrade Steps</h2>
<ul>
<li>Upload or copy the latest iRedAdmin to your server which has iRedAdmin
open source edition or old iRedAdmin-Pro release running. We assume you
uploaded it to <code>/root/iRedAdmin-x.y.z.tar.bz2</code> (<code>x.y.z</code> is a placeholder of
the version number).</li>
<li>Uncompress and upgrade iRedAdmin:</li>
</ul>
<pre><code># cd /root/
# tar xjf iRedAdmin-x.y.z.tar.bz2
# cd iRedAdmin-x.y.z/tools/
# bash upgrade_iredadmin.sh
</code></pre>
<p>That's all. If it doesn't work for you, please post a new topic in our
<a href="https://forum.iredmail.org/">online support forum</a>.</p>
<h2 id="additional-steps">Additional steps</h2>
<ul>
<li>
<p>To quarantine SPAM/Virus into SQL database and manage them with
iRedAdmin-Pro, please follow this tutorial to update Amavisd settings:
<a href="./quarantining.html">Quarantining SPAM and Virus emails into SQL database</a></p>
</li>
<li>
<p>To manage white/blacklist with iRedAdmin-Pro, please enable
per-recipient policy lookup in Amavisd, and enable plugin <code>amavisd_wblist</code>
in iRedAPD config file (<code>/opt/iredapd/settings.py</code>, parameter <code>plugins =</code>):
<a href="./amavisd.per-recipient.policy.lookup.html">Amavisd: Enable per-recipient policy lookup</a></p>
<p>Note: Cluebringer still provides white/blacklists, but iRedAdmin-Pro
doesn't manage them anymore after iRedMail-0.9.0 release. So please
migreate Cluebringer white/blacklists to Amavisd database by following
this <a href="https://forum.iredmail.org/post35480.html#p35480">forum post</a>.</p>
</li>
</ul><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>