2016-05-19 06:51:20 -05:00
<!DOCTYPE html>
2014-09-30 10:13:21 -05:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
2014-12-04 08:19:58 -06:00
< title > Migrate or upgrade iRedAdmin< / title >
2015-07-31 23:14:52 -05:00
< link rel = "stylesheet" type = "text/css" href = "./css/markdown.css" / >
2014-09-30 10:13:21 -05:00
< / head >
< body >
< div id = "navigation" >
2016-04-19 12:48:51 -05:00
< a href = "/index.html" target = "_blank" >
< img alt = "iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"
/>
< span > iRedMail< / span >
< / a >
2016-02-29 02:15:19 -06:00
// < a href = "./index.html" > Document Index< / a > < / div > < h1 id = "migrate-or-upgrade-iredadmin" > Migrate or upgrade iRedAdmin< / h1 >
2014-09-30 10:13:21 -05:00
< div class = "toc" >
< ul >
2014-12-04 08:19:58 -06:00
< li > < a href = "#migrate-or-upgrade-iredadmin" > Migrate or upgrade iRedAdmin< / a > < ul >
2014-09-30 10:13:21 -05:00
< li > < a href = "#requirements" > Requirements< / a > < / li >
2015-01-04 00:21:04 -06:00
< li > < a href = "#download-the-latest-iredadmin" > Download the latest iRedAdmin< / a > < / li >
2014-09-30 10:13:21 -05:00
< li > < a href = "#upgrade-steps" > Upgrade Steps< / a > < / li >
2015-01-11 00:44:34 -06:00
< li > < a href = "#additional-steps" > Additional steps< / a > < / li >
2014-09-30 10:13:21 -05:00
< / ul >
< / li >
< / ul >
< / div >
2016-05-03 22:08:55 -05:00
< 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 >
2014-12-03 08:51:42 -06:00
< 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 >
2014-09-30 10:13:21 -05:00
< h2 id = "requirements" > Requirements< / h2 >
2015-12-14 09:00:43 -06:00
< 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 >
2016-05-03 22:08:55 -05:00
< ul >
< li >
2015-12-14 09:00:43 -06:00
< p > If you run the latest iRedAdmin-Pro with old iRedMail release, you may
2016-05-03 22:08:55 -05:00
get error due to missing some required ldap attribute/value pairs
(OpenLDAP backend), or missing some required SQL columns.< / p >
< / li >
< li >
2015-12-14 09:00:43 -06:00
< p > If you run the latest iRedMail with old iRedAdmin-Pro, you may get error
2016-05-03 22:08:55 -05:00
due to missing dropped SQL columns, or created accounts may miss some
properties required by the latest iRedMail.< / p >
< / li >
< / ul >
2015-12-14 09:00:43 -06:00
< / li >
< li >
2015-01-04 00:21:04 -06:00
< p > You < strong > MUST< / strong > have iRedAdmin open source edition or old iRedAdmin-Pro release
2015-12-14 09:00:43 -06:00
installed and running on your server before upgrading.< / p >
< / li >
< / ol >
2015-01-04 00:21:04 -06:00
< h2 id = "download-the-latest-iredadmin" > Download the latest iRedAdmin< / h2 >
2014-09-30 10:13:21 -05:00
< ul >
2015-12-14 09:00:43 -06:00
< li > iRedAdmin open source edition is available for download < a href = "http://www.iredmail.org/yum/misc/" > here< / a > .< / li >
2015-01-04 00:21:04 -06:00
< li >
2015-12-14 09:00:43 -06:00
< p > iRedAdmin-Pro customers can get download link of new release by following
steps below:< / p >
2015-01-04 00:21:04 -06:00
< 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 >
2015-12-14 09:00:43 -06:00
< p > If you cannot download iRedAdmin-Pro for some reason, please < a href = "../contact.html" > contact us< / a > .< / p >
2015-01-04 00:21:04 -06:00
< / li >
2014-09-30 10:13:21 -05:00
< / ul >
< h2 id = "upgrade-steps" > Upgrade Steps< / h2 >
< ul >
2016-05-03 22:08:55 -05:00
< li > Upload or copy the latest iRedAdmin to your server which has iRedAdmin
2015-12-14 09:00:43 -06:00
open source edition or old iRedAdmin-Pro release running. We assume you
2016-05-03 22:08:55 -05:00
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 >
2014-09-30 10:13:21 -05:00
< / ul >
< pre > < code > # cd /root/
2014-12-23 08:42:44 -06:00
# tar xjf iRedAdmin-x.y.z.tar.bz2
# cd iRedAdmin-x.y.z/tools/
2014-09-30 10:13:21 -05:00
# 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 = "http://www.iredmail.org/forum/" > online support forum< / a > .< / p >
2015-01-11 00:44:34 -06:00
< h2 id = "additional-steps" > Additional steps< / h2 >
2014-09-30 10:13:21 -05:00
< ul >
2014-12-23 08:42:44 -06:00
< 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
2015-01-11 00:44:34 -06:00
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 = "http://www.iredmail.org/forum/post35480.html#p35480" > forum post< / a > .< / p >
2014-12-23 08:42:44 -06:00
< / li >
2016-05-19 06:51:20 -05:00
< / 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" >
2015-02-05 07:02:53 -06:00
(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');
2014-10-13 19:28:43 -05:00
< / script >
< / body > < / html >