IRedMail/FAQ/Upgrade.iRedAPD

From iRedMail

(Difference between revisions)

Revision as of 23:50, 12 March 2013

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/.

Terminal:

# 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:

Terminal:

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

Create symbol link to the latest release:

Terminal:

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

Set correct owner and permission:

Terminal:

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

Copy config file from sample file, and set correct file owner and permission.

Terminal:

# 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.

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.

Terminal:

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

Restart iRedAPD service:

Terminal:

#
# ---- 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 = .

@@ Line 1: / Line 1: @@
 ----
-This tutorial describes how to upgrade iRedAPD to the latest stable release. It's applicable on all Linux/BSD distributions supported by 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.3.8.tar.bz2.
+* 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.3.8.tar.bz2 on the server.
+* 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/.
 {{cmd|<pre>
-# tar xjf /root/iRedAPD-1.3.8.tar.bz2 -C /opt/
+# tar xjf /root/iRedAPD-1.4.0.tar.bz2 -C /opt/
 </pre>}}
-You get a new directory: /opt/iRedAPD-1.3.8/.
+You get a new directory: /opt/iRedAPD-1.4.0/.
 * Remove symbol link of old release:
 {{cmd|<pre>
@@ Line 19: / Line 23: @@
 {{cmd|<pre>
 # cd /opt/
-# ln -s iRedAPD-1.3.8 iredapd
+# ln -s iRedAPD-1.4.0 iredapd
 </pre>}}
@@ Line 28: / Line 32: @@
 </pre>}}
-* Copy config file from installed old release on your server. For example, 1.3.7. And set correct file owner and permission:
+* Copy config file from sample file, and set correct file owner and permission.
 {{cmd|<pre>
-# cp /opt/iRedAPD-1.3.7/etc/*.ini /opt/iredapd/etc/
+# cd /opt/iredapd/
-# chown -R iredapd:iredapd /opt/iredapd/etc/*.ini
+# cp settings.py.sample settings.py
-# chmod -R 0600 /opt/iredapd/etc/*.ini
+# chown -R iredapd:iredapd settings.py
+# chmod -R 0600 settings.py
 </pre>}}
+WARNING: Config file '''/opt/iredapd/settings.py''' contains sensitive infomation (username, password), please don't make it world-readable. Permission 0600 is the best.
-'''Important Notes''':
+* Please open /opt/iredapd/settings.py, and sync settings with old iRedAPD config file '''/opt/iRedAPD-[OLD-VERSION]/etc/iredapd.ini'''.
-* 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.
+* 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.
+{{cmd|<pre>
+# cp /opt/iredapd/rc_scripts/iredapd.rhel /etc/init.d/iredapd
+</pre>}}
 * Restart iRedAPD service:
@@ Line 57: / Line 72: @@
 </pre>}}
-Note: If you have '''iredapd-rr''' service enabled, please restart it too.
+If you have '''iredapd-rr''' service enabled, please stop it and list enabled plugins in '''/opt/iredapd/settings.py''', parameter '''plugins = '''.
 [[Category: FAQ]]
 [[Category: iRedMail/FAQ]]

IRedMail/FAQ/Upgrade.iRedAPD

From iRedMail

Revision as of 23:50, 12 March 2013

Views

Personal tools

Navigation

Search

Toolbox