IRedMail/FAQ/Upgrade.iRedAPD

From iRedMail

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

Important notes:

• Since iRedAPD-1.4.0, we use Python source file as config file, not '.ini' format anymore.
• We don't need second instance, iredapd-rr, anymore.

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

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

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

• 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.4.0 iredapd

• Set correct owner and permission:

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

• Generate new config file from sample file, and set correct file owner and permission.

# cd /opt/iredapd/
# cp settings.py.sample settings.py
# chown -R iredapd:iredapd settings.py
# chmod -R 0600 settings.py

WARNING: Config file /opt/iredapd/settings.py contains sensitive infomation (username, password), please don't make it world-readable. Permission 0600 is the best.

• Please open /opt/iredapd/settings.py, and sync settings with old iRedAPD config file /opt/iRedAPD-[OLD-VERSION]/etc/iredapd.ini.
  • In old version of iRedAPD, all parameters under "[ldap]" section are now new parameters start with ldap_.
  • In old version of iRedAPD, all parameters under "[sql]" (or "[mysql]") section are now new parameters start with sql_.

• After sync settings, please copy new RC script for your server. We have scripts for different Please copy the proper one for your server. For example:
  • iredapd.debian: For Debian and Ubuntu.
  • iredapd.freebsd: For FreeBSD. Please copy to /usr/local/etc/rc.d/.
  • iredapd.gentoo: For Gentoo Linux.
  • iredapd.openbsd: For OpenBSD.
  • iredapd.opensuse: For openSUSE.
  • iredapd.rhel: For Red Hat, CentOS, Scientific Linux.

# cp /opt/iredapd/rc_scripts/iredapd.rhel /etc/init.d/iredapd

• 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

If you have iredapd-rr service enabled, please stop it and list enabled plugins in /opt/iredapd/settings.py, parameter plugins = .