IRedMail/FAQ/Upgrade.Roundcube.Webmail

From iRedMail

THIS IS A DRAFT TUTORIAL, DO NOT APPLY IT.

This tutorial is used to upgrade Roundcube from old release to the latest release.

• Backup current Roundcube database first.

{{

# mysqldump -u root -p roundcubemail > /root/mysql-db-roundcubemail.sql

}}

• Download the latest Roundcube webmail here: http://roundcube.net/. Here we take 0.7.1 for example: /root/roundcubemail-0.7.1.tar.gz

• Extract it in the right place :

{{

# ---- For Debian/Ubuntu ----
# tar xzf /root/roundcubemail-0.7.1.tar.gz -C /usr/share/apache2/
# cd /usr/share/apache2/
# mkdir temp logs
# chown www-data:www-data temp logs

}}

• Copy config files from old release to new release. For example:

{{

# cd /usr/share/apache2/
# cp -a roundcubemail-0.5.2/config/main.inc.php roundcubemail-0.7.1/config/
# cp -a roundcubemail-0.5.2/config/db.inc.php roundcubemail-0.7.1/config/

}}

• Remove symbol link and create a new one, link to new release:

{{

# cd /usr/share/apache2/
# rm roundcubemail
# ln -s roundcubemail-0.7.1 roundcubemail

}}

• Enable Roundcube installer by update below setting in roundcubemail-0.7.1/config/main.inc.php:

{{

$rcmail_config['enable_installer'] = true;

}}

If the installer reports your server misses some required packages or PHP modules, please install them manually to fix them.

• Set correct time zone in your PHP config file: /etc/php5/apache2/php.ini. For example:

{{

date.timezone = "Europe/Paris"

}}

• Restart Apache web server if you have new required packages or PHP modules installed:

{{

# /etc/init.d/apache2 restart

}}

• Upgrade Roundcube database structure by importing shipped SQL file:

{{

# cd /usr/share/apache2/roundcubemail-0.7.1/
# mysql -uroot -p
mysql> USE roundcubemail;
mysql> SOURCE SQL/mysql.update.sql;

}}

• Access Roundcube installer with this URL: httpS://your_server/mail/installer , it will validate required packages, PHP modules and database structure.

• Roundcube installer also gives the way to download main.inc.php and db.inc.php files, please download them and replace your old config files. Because old config files might miss some parameters. Don't forget to fix file permission after replaced:

{{

# cd /usr/share/apache2/
# chown www-data:www-data config/*

}}

• After Roundcube installer finished upgrading process, disable installer in config file 'config/main.inc.php' by updating below parameter:

{{

$rcmail_config['enable_installer'] = false;

}}

That's all.