2016-05-19 06:51:20 -05:00
<!DOCTYPE html>
2015-05-02 09:24:42 -05:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > Upgrade iRedAPD from v1.3.x or earlier versions to latest release< / title >
2015-07-31 23:14:52 -05:00
< link rel = "stylesheet" type = "text/css" href = "./css/markdown.css" / >
2015-05-02 09:24:42 -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 = "upgrade-iredapd-from-v13x-or-earlier-versions-to-latest-release" > Upgrade iRedAPD from v1.3.x or earlier versions to latest release< / h1 >
2016-04-25 21:19:09 -05:00
< div class = "admonition attention" >
< p class = "admonition-title" > Attention< / p >
< ul >
< li > If you're trying to upgrade iRedAPD-1.4.0 or later releases to the latest
iRedAPD, please check this tutorial instead: < a href = "./upgrade.iredapd.html" > Upgrade iRedAPD< / a > < / li >
< li > We provide remote upgrade service, check < a href = "../support.html" > the price< / a > and < a href = "../contact.html" > contact us< / a > .< / li >
< / ul >
< / div >
2015-05-02 09:24:42 -05:00
< p > This tutorial describes how to upgrade iRedAPD from v1.3.x or earlier versions
to the later releases, it's applicable on all Linux/BSD distributions supported
by iRedMail.< / p >
2016-02-29 07:18:38 -06:00
< div class = "admonition note" >
< p class = "admonition-title" > Important Notes< / p >
2015-05-02 09:24:42 -05:00
< ul >
2016-02-29 07:18:38 -06:00
< li > Since iRedAPD-< code > 1.4.0< / code > , we use Python source file as config file, not
< code > .ini< / code > format anymore.< / li >
< li > We don't need second instance < code > iredapd-rr< / code > anymore (it listens on port
< code > 7778< / code > ), just one instance, one listen port < code > 7777< / code > is required.< / li >
2015-05-02 09:24:42 -05:00
< / ul >
2016-02-29 07:18:38 -06:00
< / div >
2015-05-02 09:24:42 -05:00
< p > Steps to upgrade iRedAPD-1.3.x or earlier versions:< / p >
< ul >
< li > Download the latest stable release here: < a href = "http://iredmail.org/yum/misc/" > http://iredmail.org/yum/misc/< / a >
For example, iRedAPD-1.4.4.tar.bz2.< / li >
< li > Upload it to your iRedMail server. Assume it's < code > /root/iRedAPD-1.4.4.tar.bz2< / code >
on the server.< / li >
< li > Extract downloaded package and move to < code > /opt/< / code > , set correct owner and permission:< / li >
< / ul >
< pre > < code > # tar xjf /root/iRedAPD-1.4.4.tar.bz2 -C /opt/
# cd /opt
# chown -R iredapd:iredapd iRedAPD-1.4.4
# chmod -R 0700 iRedAPD-1.4.4
< / code > < / pre >
< ul >
< li > Generate new config file from sample file, and set correct file owner and permission.< / li >
< / ul >
< pre > < code > # cd /opt/iRedAPD-1.4.4/
# cp settings.py.sample settings.py
# chown -R iredapd:iredapd settings.py
# chmod -R 0400 settings.py
< / code > < / pre >
< p > < strong > WARNING< / strong > : Config file < code > /opt/iredapd/settings.py< / code > contains sensitive infomation
(username, password), please don't make it world-readable. Permission 0400 is
the best.< / p >
< ul >
< li >
< p > Open iRedAPD config file < code > /opt/iredapd/settings.py< / code > , and sync settings with
old iRedAPD config file < code > /opt/iRedAPD-[OLD-VERSION]/etc/iredapd.ini< / code > .< / p >
< ul >
< li > In old version, parameters under < code > [ldap]< / code > section are now new parameters
start with < code > ldap_< / code > .< / li >
< li > In old version, all parameters under < code > [sql]< / code > (or < code > [mysql]< / code > ) section are
now new parameters start with < code > sql_< / code > .< / li >
< / ul >
< / li >
< li >
< p > Remove symbol link of old release:< / p >
< / li >
< / ul >
< pre > < code > # rm -i /opt/iredapd # < - Don't not end with '/'.
< / code > < / pre >
< ul >
< li >
< p > Copy new RC script. We have scripts for different Linux/BSD distributions,
please copy the correct one for your distribution:< / p >
< ul >
< li > < code > /opt/iredapd/rc_scripts/iredapd.rhel< / code > : For Red Hat, CentOS, Scientific Linux.< / li >
< li > < code > /opt/iredapd/rc_scripts/iredapd.debian< / code > : For Debian and Ubuntu.< / li >
< li > < code > /opt/iredapd/rc_scripts/iredapd.freebsd< / code > : For FreeBSD. Please copy to < code > /usr/local/etc/rc.d/< / code > .< / li >
< li > < code > /opt/iredapd/rc_scripts/iredapd.openbsd< / code > : For OpenBSD. Please copy to < code > /etc/rc.d/< / code > .< / li >
< / ul >
< / li >
< / ul >
< pre > < code > # cp /opt/iredapd/rc_scripts/iredapd.rhel /etc/init.d/iredapd
# chmod +x /etc/init.d/iredapd
< / code > < / pre >
< ul >
< li > Create symbol link to the latest release:< / li >
< / ul >
< pre > < code > # cd /opt/
# ln -s iRedAPD-1.4.4 iredapd
< / code > < / pre >
< ul >
< li > Restart iRedAPD service:< / li >
< / ul >
< pre > < code > #
# ---- On Linux ----
#
# /etc/init.d/iredapd restart
#
# ---- On FreeBSD ----
#
# /usr/local/etc/rc.d/iredapd restart
#
# ---- On OpenBSD ----
#
# /etc/rc.d/iredapd restart
< / code > < / pre >
< ul >
< li > If you don't have file < code > /etc/init.d/iredapd-rr< / code > (on Linux), or
< code > /etc/rc.d/iredapd-rr< / code > (on OpenBSD), or < code > /usr/local/etc/rc.d/iredapd-rr< / code >
(on FreeBSD), it's safe to ignore below steps. But if you have it, please
stop service < code > iredapd-rr< / code > , then move all enabled plugin names listed in
< code > /opt/iRedAPD-[OLD_VERSION]/etc/iredapd-rr.ini< / code > to new config file
< code > /opt/iredapd/settings.py< / code > , in parameter < code > plugins =< / code > .< / li >
< / ul >
< pre > < code > # /etc/init.d/iredapd-rr stop
# rm /etc/init.d/iredapd-rr
< / code > < / pre >
< p > Check whether you have < code > check_policy_service inet:127.0.0.1:__7778__< / code > in Postfix
config file < code > /etc/postfix/main.cf< / code > (Linux/OpenBSD) or
< code > /usr/local/etc/postfix/main.cf< / code > (FreeBSD), if you have it, please remove it,
2016-05-19 06:51:20 -05:00
then restart Postfix service.< / p > < 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-05-02 09:24:42 -05: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');
< / script >
< / body > < / html >