Migrate/iRedAdmin-Pro/OSE-Pro

From iRedMail
(Difference between revisions)
Jump to: navigation, search

Revision as of 21:26, 9 January 2014

Contents


This tutorial explains how to migrate iRedAdmin open source edition (v0.1.7 and later versions) to iRedAdmin-Pro (full-featured edition).

If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/

Some notes:

  • It works with both iRedAdmin-Pro-LDAP, iRedAdmin-Pro-MySQL and iRedAdmin-Pro-PGSQL.
  • Please replace 'iRedAdmin-Pro-x.y.z' below with your real edition and version numbers. e.g. iRedAdmin-Pro-MySQL-1.3.1, iRedAdmin-Pro-LDAP-1.6.3.

Requirements and Notes

  • This tutorial is applicable to iRedMail-0.8.0 and later versions. If you're using iRedMail-0.7.4 or earlier versions, please refer to this tutorial.
  • You MUST select to install iRedAdmin open source edition during iRedMail installation.

Summary

It's easy to migrate from iRedAdmin open source edition to iRedAdmin-Pro. Steps:

  • Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-xxx.tar.bz2.
  • Uncompress iRedAdmin-Pro to apache server root directory.
  • Copy config file from open source edition. We assume you're using iRedAdmin-0.1.7 (open source edition) in this tutorial, it's shipped in iRedMail-0.8.0.
  • Set correct file permission for iRedAdmin-Pro.
  • Restart apache web server.
  • [OPTIONAL] Enable quarantining in Amavisd and restart amavisd service.

Upload or copy iRedAdmin-Pro to your server

Upload or copy iRedAdmin-Pro to your server which has iRedMail running. We assume you uploaded it to /root/iRedAdmin-Pro-LDAP-x.y.z.tar.bz2 or /root/iRedAdmin-Pro-MySQL-x.y.z.tar.bz2, or /root/iRedAdmin-Pro-PGSQL-x.y.z.tar.bz2.

We will use iRedAdmin-Pro-x.y.z below, please replace x.y.z by the real file name, e.g. iRedAdmin-Pro-LDAP-1.6.3.tar.bz2, etc.

Uncompress iRedAdmin-Pro, copy config file, set correct file permission, restart apache

For Red Hat Enterprise Linux, CentOS, Scientific Linux

Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin    # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.3/settings.py iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/    # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py

# /etc/init.d/httpd restart    # <- Restart apache web server

For Debian, Ubuntu, Mint Linux

Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/share/apache2/
# cd /usr/share/apache2/
# rm -i /usr/share/apache2/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.3/settings.py iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py

# /etc/init.d/apache2 restart            # <- Restart apache web server

For openSUSE

Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /srv/www/
# cd /srv/www/
# rm -i /srv/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.3/settings.py iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py

# /etc/init.d/apache2 restart            # <- Restart apache web server

For Gentoo Linux

Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.3/settings.py iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py

# /etc/init.d/apache2 restart            # <- Restart apache web server

For FreeBSD

Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /usr/local/www/
# cd /usr/local/www/
# rm -i /usr/local/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.3/settings.py iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py

# /usr/local/etc/rc.d/apache2 restart          # <- Restart apache web server

For OpenBSD

Terminal:
# tar xjf /root/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin                 # <- this is a symbol link, it will prompt you to type 'y' to confirm.
# ln -s iRedAdmin-Pro-x.y.z iredadmin
# cp -p iRedAdmin-0.3/settings.py iRedAdmin-Pro-x.y.z/

# chown -R iredadmin:iredadmin iRedAdmin-Pro-x.y.z/              # <- Set correct file permission for iRedAdmin-Pro.
# chmod -R 0555 iRedAdmin-Pro-x.y.z
# chown www:iredadmin iRedAdmin-Pro-x.y.z/settings.py
# chmod -R 0400 iRedAdmin-Pro-x.y.z/settings.py

# /etc/rc.d/httpd restart            # <- Restart apache web server

Converting old config file to new format

If your old iRedAdmin-Pro still uses "settings.ini" as config file, you have to convert it to new config file format (and new file name) with below commands. All commands are executed under your iRedAdmin-Pro directory:

Terminal:
# bash tools/convert_ini_to_py.sh settings.ini      # <- It will convert settings.ini to new config file "settings.py"
# chown iredadmin:iredadmin settings.py
# chmod 0400 settings.py
# rm settings.ini

Please restart Apache service after you converted config file.

Quarantining SPAMs and manage them with iRedAdmin-Pro

Note: This step is REQUIRED if you want to quarantine spam, virus into SQL (MySQL or PostgreSQL) database, then delete or release them with iRedAdmin-Pro.

Since iRedMail-0.7.0, quarantining related settings are configured but disabled by default, you can easily enable quarantining with below tutorial. (Don't worry, it's easy enough.)

Troubleshooting

If it doesn't work for you, please post a new topic in our forum: http://www.iredmail.org/forum/

Personal tools