1

Topic: [FAQ] How to migrate from open source edition to full-featured edition

This tutorial is used to explain how to migrate iRedAdmin open source edition to iRedAdmin-Pro (full-featured edition). If it doesn't work for you, please post a new topic in our iRedAdmin support forum.

=========================================================================
How to migrate from iRedAdmin open source edition to iRedAdmin-Pro full-featured edition.
=========================================================================

iRedMail ships iRedAdmin open source edition since iRedMail-0.5.1, it's easy to migrate from open source edition to full-featured edition. 3 steps:

  • Configure OpenLDAP

  • Uncompress full-featured edition to apache document root

  • Update SQL structure

  • Copy settings.ini from open source edition to full-featured edition

Configure OpenLDAP

Since version 1.1.0, iRedAdmin-Pro requires OpenLDAP to use Amavisd LDAP schema for better integration, so you need to include amavisd ldap schema in OpenLDAP.

  • Make sure OpenLDAP includes amavisd schema file. If it doesn't present, add it.

# ---- RHEL/CentOS ----
# File: /etc/openldap/slapd.conf
include /etc/openldap/schema/amavisd-new.schema

# ---- Debian/Ubuntu ----
# File: /etc/ldap/slapd.conf
include /etc/ldap/schema/amavis.schema

# ---- FreeBSD ----
# File: /usr/local/etc/openldap/slapd.conf
include /usr/local/etc/openldap/schema/amavisd-new.schema
  • Restart OpenLDAP service.

# ---- RHEL/CentOS ----
# /etc/init.d/ldap restart

# ---- Debian/Ubuntu ----
# /etc/init.d/slapd restart

# ---- FreeBSD ----
# /usr/local/etc/rc.d/slapd restart
Uncompress iRedAdmin-Pro to apache document root
# ---- RHEL/CentOS ----
# tar xjf /path/to/iRedAdmin-Pro-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/
# rm -i /var/www/iredadmin                 # <- this is a symbol link
# ln -s iRedAdmin-Pro-x.y.z iredadmin

# ---- Debian/Ubuntu ----
# tar xjf /path/to/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
# ln -s iRedAdmin-Pro-x.y.z iredadmin

# ---- FreeBSD ----
# tar xjf /path/to/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
# ln -s iRedAdmin-Pro-x.y.z iredadmin
Update SQL structure

iRedAdmin-Pro has some more SQL tables, we should update exist SQL structure which created by open source edition.

# mysql -uroot -p
mysql> USE iredadmin;
mysql> DELETE FROM sessions;              # <-- Force admins to re-login.

# ---- RHEL/CentOS ----
mysql> SOURCE /var/www/iredadmin/docs/samples/iredadmin.sql;

# ---- Debian/Ubuntu ----
mysql> SOURCE /usr/share/apache2/iredadmin/docs/samples/iredadmin.sql;

# ---- FreeBSD ----
mysql> SOURCE /usr/local/www/iredadmin/docs/samples/iredadmin.sql;

Note: table 'sessions' contains login session, admins have to re-login after upgrade.

Copy settings.ini.ldap.sample as settings.ini, sync settings.ini from open source edition.

Copy settings.ini.ldap.sample as settings.ini:

# ---- RHEL/CentOS ----
# cd /var/www/iredadmin/
# cp settings.ini.ldap.sample settings.ini

# ---- Debian/Ubuntu ----
# cd /usr/share/apache2/iredadmin/
# cp settings.ini.ldap.sample settings.ini

# ---- FreeBSD ----
# cd /usr/local/www/iredadmin/
# cp settings.ini.ldap.sample settings.ini

Sync settings between open source edition and new settings.ini, include database name, username, password, webmaster email address, etc. one bye one.

Restart web server to make it work:

# ---- RHEL/CentOS ----
# /etc/init.d/httpd restart

# ---- Debian/Ubuntu ----
# /etc/init.d/apache2 restart

# ---- FreeBSD ----
# /usr/local/etc/rc.d/apache2 restart