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" >
2017-11-16 21:48:44 -06:00
< a href = "https://www.iredmail.org" target = "_blank" >
2016-04-19 12:48:51 -05:00
< 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,
2017-11-16 21:48:44 -06:00
check < a href = "https://www.iredmail.org/support.html" > the details< / a > and
< a href = "https://www.iredmail.org/contact.html" > contact us< / a > .< / p >
2016-05-03 22:08:55 -05:00
< / div >
2018-12-19 06:49:51 -06:00
< div class = "admonition attention" >
< p class = "admonition-title" > Attention< / p >
< p > Since iRedAdmin-0.9.2 (open source edition), and iRedAdmin-Pro-SQL-3.0,
iRedAdmin-Pro-LDAP-3.2, iRedAdmin or iRedAdmin-Pro is running as a
standalone service named "iredadmin", each time you modified its config
file, please restart the service ("iredadmin").< / 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 >
2017-11-16 21:48:44 -06:00
< li > iRedAdmin open source edition is available for download < a href = "https://dl.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 >
2017-11-16 21:48:44 -06:00
< p > If you cannot download iRedAdmin-Pro for some reason, please < a href = "https://www.iredmail.org/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 >
2017-10-30 23:40:38 -06:00
< div class = "admonition warning" >
< p class = "admonition-title" > Warning< / p >
< p > Do not rename the extracted directory (< code > iRedAdmin-x.y.z< / code > ), otherwise
upgrade may fail.< / p >
< / div >
2014-09-30 10:13:21 -05:00
< 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
2017-10-26 08:13:46 -05:00
< a href = "https://forum.iredmail.org/" > 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
2018-03-28 13:16:59 -06:00
migrate Cluebringer white/blacklists to Amavisd database by following
2017-10-26 08:13:46 -05:00
this < a href = "https://forum.iredmail.org/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" >
2017-11-16 21:48:44 -06:00
< 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 = "https://www.iredmail.org/contact.html" > contact us< / a > to fix it.< / p >
2016-05-19 06:51:20 -05:00
< / div >
2017-11-05 02:33:58 -06:00
<!-- Global site tag (gtag.js) - Google Analytics -->
< script async src = "https://www.googletagmanager.com/gtag/js?id=UA-3293801-21" > < / script >
< script >
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
2015-02-05 07:02:53 -06:00
2017-11-05 02:33:58 -06:00
gtag('config', 'UA-3293801-21');
2014-10-13 19:28:43 -05:00
< / script >
< / body > < / html >
