1

Topic: How to: Upgrade iRedAdmin-Pro-1.0.x to v1.1.0

Hi, all.

iRedAdmin-Pro-1.1.0 is available now, and here is tutorial to help you to upgrade your exist v1.0.x to v1.1.0.
===========

Steps:

  • Include amavisd-new LDAP schema in OpenLDAP.

  • Backup exist iRedAdmin.

  • Update SQL structure and add extra SQL tables.

  • Install iRedAPD for mail list access restriction.

*) iRedAdmin-1.1.0 is starting to integrate Amavisd-new, so we have to Include amavisd-new schema in OpenLDAP.
  • On RHEL/CentOS, add below line in /etc/openldap/slapd.conf, before line 'include /etc/openldap/schema/iredmail.schema'.

include /etc/openldap/schema/amavisd-new.schema
  • On Debian/Ubuntu, add below line in /etc/ldap/slapd.conf, before line 'include /etc/openldap/schema/iredmail.schema'.

include /etc/openldap/schema/amavis.schema
  • Restart OpenLDAP service to make it work.

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

# ---- Debian/Ubuntu ----
# /etc/init.d/slapd restart
*) Backup your exist iRedAdmin to /opt/ or whatever directory you want.
# cp -rfp /var/www/iRedAdmin-old/ /opt/
*) Extract new version to /var/www/ (RHEL/CentOS) or /usr/share/apache2/ (Debian/Ubuntu).
# ==== On RHEL/CentOS ====
# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
# cd /var/www/

# ==== On Debian/Ubuntu ====
# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /usr/share/apache2/
# cd /usr/share/apache2/

# rm iredadmin              # <- this is a symbol link, don't append slash '/' after 'iredadmin'.
# ln -s iRedAdmin-1.1.0 iredadmin
*) Copy old config file and add missing parameters.
# cp /opt/iRedAdmin-1.0.2/settings.ini /var/www/iredadmin/
# chmod u+w /var/www/iredadmin/settings.ini

Add new parameters in section [general] of settings.ini manually:

[general]
mail_error_to_webmaster = False
*) Make config file read-only again.
# chmod -w /var/www/iredadmin/settings.ini
*) Restart apache web server to make iRedAdmin work.
# ==== RHEL/CentOS ====
# /etc/init.d/httpd restart

# ==== Debian/Ubuntu ====
# /etc/init.d/apache2 restart
*) Update SQL structure and add extra SQL tables.

used to log all admin operations:

You should run below commands in shell terminal.

  • Add new table: iredadmin.log, used to log all admin operations.

$ mysql -uroot -p
mysql> USE iredadmin;

# ==== On RHEL/CentOS ====
mysql> SOURCE /var/www/iredadmin/docs/upgrade_v1.0.x_v1.1.0/upgrade_100_110.sql;

# ==== On Debian/Ubuntu ====
mysql> SOURCE /usr/share/apache2/iredadmin/docs/upgrade_v1.0.x_v1.1.0/upgrade_100_110.sql;
  • Convert some policyd columns to character 'utf-8', so that we can use multi-bytes characters in 'description' column.

$ mysql -uroot -p
mysql> USE policyd;

# ==== On RHEL/CentOS ====
mysql> SOURCE /var/www/iredadmin/docs/upgrade_v1.0.x_v1.1.0/policyd.utf8.sql;

# ==== On Debian/Ubuntu ====
mysql> SOURCE /usr/share/apache2/iredadmin/docs/upgrade_v1.0.x_v1.1.0/policyd.utf8.sql;
*) Install iRedAPD for mail list access restriction.

iRedAPD is designed to work in conjunction with Postfix as an Access Policy Delegation daemon, currently, iRedMail uses it to provide mail list access restriction.

Please refer to iRedAPD installation guide to get mail list access restriction feature.

2

Re: How to: Upgrade iRedAdmin-Pro-1.0.x to v1.1.0

Anyone experiencing any errors?