IRedMail/FAQ/Upgrade.iRedAPD

From iRedMail

Revision as of 08:32, 3 October 2012

This tutorial describes how to upgrade iRedAPD to the latest stable release. It's applicable on all Linux/BSD distributions supported by iRedMail.

• Download the latest stable release here: http://iredmail.org/yum/misc/ For example, iRedAPD-1.3.8.tar.bz2.
• Upload it to your iRedMail server. Assume it's /root/iRedAPD-1.3.8.tar.bz2 on the server.
• Extract downloaded package and move to /opt/.

# tar xjf /root/iRedAPD-1.3.8.tar.bz2 -C /opt/

You get a new directory: /opt/iRedAPD-1.3.8/.

• Remove symbol link of old release:

# rm -i /opt/iredapd               # <- Don't not end with '/'.

• Create symbol link to the latest release:

# cd /opt/
# ln -s iRedAPD-1.3.8 iredapd

• Set correct owner and permission:

# chown -R iredapd:iredapd /opt/iredapd
# chmod -R 0700 /opt/iredapd

• Copy config file from installed old release on your server. For example, 1.3.7. And set correct file owner and permission:

# cp /opt/iRedAPD-1.3.7/etc/*.ini /opt/iredapd/etc/
# chown -R iredapd:iredapd /opt/iredapd/etc/*.ini
# chmod -R 0600 /opt/iredapd/etc/*.ini

Important Notes:

• There's a section named "[mysql]" in iRedAPD config files if you're running old version, it was renamed to [sql] in new release.
• Please compare copied config file(s) to sample config files under /opt/iredapd/etc/, make sure copied config file(s) has all required parameters in it. For example, compare /opt/iredapd/etc/iredapd.ini and /opt/iredapd/etc/iredapd.ini.sample.

• Restart iRedAPD service:

#
# ---- On Linux ----
#
# /etc/init.d/iredapd restart

#
# ---- On FreeBSD ----
#
# /usr/local/etc/rc.d/iredapd restart

#
# ---- On OpenBSD ----
#
# /etc/rc.d/iredapd restart

Note: If you have iredapd-rr service enabled, please restart it too.