IRedMail/FAQ/Upgrade.iRedAdmin.Open.Source.Edition

From iRedMail
Jump to: navigation, search

  • This tutorial describes how to upgrade iRedAdmin (open source edition) to the latest stable release.
  • You can upgrade iRedAdmin open source edition from 0.2.2 (or earlier versions) to 0.3 or later releases.


  • Download the latest iRedAdmin (open source edition) here: http://iredmail.org/yum/misc/. For example: iRedAdmin-0.3.tar.bz2.
  • Upload downloaded package to your iRedMail server which has old version running. Assume it's /root/iRedAdmin-0.3.tar.bz2.
  • Uncompress it to correct directory, set correct file owner and permission, convert config file to python file format, restart Apache web server.
Terminal:
#
# ---- On RHEL/CentOS/Scientific Linux ----
# ---- On OpenBSD ----
#
# tar xjf /root/iRedAdmin-0.3.tar.bz2 -C /var/www/
# cd /var/www/
# cp -p iRedAdmin-0.2.2/settings.ini iRedAdmin-0.3/
# cd iRedAdmin-0.3/
# bash tools/convert_ini_to_py.sh settings.ini       # <-- This step is required if you're upgrading from iRedAdmin-0.2.2 or earlier release.
# rm -f settings.ini
# cd ../
# chown -R iredadmin:iredadmin iRedAdmin-0.3
# chmod -R 0555 iRedAdmin-0.3
# chmod 0400 iRedAdmin-0.3/settings.*
# rm -i iredadmin              # <- Remove old symbol link
# ln -s iRedAdmin-0.3 iredadmin          # Create a new symbol link
# /etc/init.d/httpd restart         # Please use /etc/rc.d/httpd instead on OpenBSD

#
# ---- On Debian/Ubuntu ----
#
# tar xjf /root/iRedAdmin-0.3.tar.bz2 -C /usr/share/apache2/
# cd /usr/share/apache2/
# cp -p iRedAdmin-0.2.2/settings.ini iRedAdmin-0.3/
# cd iRedAdmin-0.3/
# bash tools/convert_ini_to_py.sh settings.ini       # <-- This step is required if you're upgrading from iRedAdmin-0.2.2 or earlier release.
# rm -f settings.ini
# cd ../
# chown -R iredadmin:iredadmin iRedAdmin-0.3
# chmod -R 0555 iRedAdmin-0.3
# chmod 0400 iRedAdmin-0.3/settings.*
# rm -i iredadmin              # <- Remove old symbol link
# ln -s iRedAdmin-0.3 iredadmin          # Create a new symbol link
# /etc/init.d/apache2 restart

#
# ---- On openSUSE ----
#
# tar xjf /root/iRedAdmin-0.3.tar.bz2 -C /srv/www/
# cd /srv/www/
# cp -p iRedAdmin-0.2.2/settings.ini iRedAdmin-0.3/
# cd iRedAdmin-0.3/
# bash tools/convert_ini_to_py.sh settings.ini       # <-- This step is required if you're upgrading from iRedAdmin-0.2.2 or earlier release.
# rm -f settings.ini
# cd ../
# chown -R iredadmin:iredadmin iRedAdmin-0.3
# chmod -R 0555 iRedAdmin-0.3
# chmod 0400 iRedAdmin-0.3/settings.*
# rm -i iredadmin              # <- Remove old symbol link
# ln -s iRedAdmin-0.3 iredadmin          # Create a new symbol link
# /etc/init.d/apache2 restart

#
# ---- On FreeBSD ----
#
# tar xjf /root/iRedAdmin-0.3.tar.bz2 -C /usr/local/www/
# cd /usr/local/www/
# cp -p iRedAdmin-0.2.2/settings.ini iRedAdmin-0.3/
# cd iRedAdmin-0.3/
# bash tools/convert_ini_to_py.sh settings.ini       # <-- This step is required if you're upgrading from iRedAdmin-0.2.2 or earlier release.
# rm -f settings.ini
# cd ../
# chown -R iredadmin:iredadmin iRedAdmin-0.3
# chmod -R 0555 iRedAdmin-0.3
# chmod 0400 iRedAdmin-0.3/settings.*
# rm -i iredadmin              # <- Remove old symbol link
# ln -s iRedAdmin-0.3 iredadmin          # Create a new symbol link
# /usr/local/etc/rc.d/apache2 restart

Note: Old iRedAdmin versions store custom settings in iredadmin/libs/settings.py, if you modified some of them, please move your modifications to the main config file: iredadmin/settings.py.

That's all.

Personal tools