IRedMail/FAQ/Upgrade.Roundcube.Webmail
From iRedMail
(Difference between revisions)
(Created page with '__TOC__ '''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…') |
|||
| Line 7: | Line 7: | ||
* Backup current Roundcube database first. | * Backup current Roundcube database first. | ||
| - | {{<pre> | + | {{cmd|<pre> |
# mysqldump -u root -p roundcubemail > /root/mysql-db-roundcubemail.sql | # mysqldump -u root -p roundcubemail > /root/mysql-db-roundcubemail.sql | ||
</pre>}} | </pre>}} | ||
| Line 15: | Line 15: | ||
* Extract it in the right place : | * Extract it in the right place : | ||
| - | {{<pre> | + | {{cmd|<pre> |
# ---- For Debian/Ubuntu ---- | # ---- For Debian/Ubuntu ---- | ||
# tar xzf /root/roundcubemail-0.7.1.tar.gz -C /usr/share/apache2/ | # tar xzf /root/roundcubemail-0.7.1.tar.gz -C /usr/share/apache2/ | ||
| Line 24: | Line 24: | ||
* Copy config files from old release to new release. For example: | * Copy config files from old release to new release. For example: | ||
| - | {{<pre> | + | {{cmd|<pre> |
# cd /usr/share/apache2/ | # 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/main.inc.php roundcubemail-0.7.1/config/ | ||
| Line 31: | Line 31: | ||
* Remove symbol link and create a new one, link to new release: | * Remove symbol link and create a new one, link to new release: | ||
| - | {{<pre> | + | {{cmd|<pre> |
# cd /usr/share/apache2/ | # cd /usr/share/apache2/ | ||
# rm roundcubemail | # rm roundcubemail | ||
| Line 38: | Line 38: | ||
* Enable Roundcube installer by update below setting in roundcubemail-0.7.1/config/main.inc.php: | * Enable Roundcube installer by update below setting in roundcubemail-0.7.1/config/main.inc.php: | ||
| - | {{<pre> | + | {{cmd|<pre> |
$rcmail_config['enable_installer'] = true; | $rcmail_config['enable_installer'] = true; | ||
</pre>}} | </pre>}} | ||
| Line 45: | Line 45: | ||
* Set correct time zone in your PHP config file: /etc/php5/apache2/php.ini. For example: | * Set correct time zone in your PHP config file: /etc/php5/apache2/php.ini. For example: | ||
| - | {{<pre> | + | {{cmd|<pre> |
date.timezone = "Europe/Paris" | date.timezone = "Europe/Paris" | ||
</pre>}} | </pre>}} | ||
* Restart Apache web server if you have new required packages or PHP modules installed: | * Restart Apache web server if you have new required packages or PHP modules installed: | ||
| - | {{<pre> | + | {{cmd|<pre> |
# /etc/init.d/apache2 restart | # /etc/init.d/apache2 restart | ||
</pre>}} | </pre>}} | ||
* Upgrade Roundcube database structure by importing shipped SQL file: | * Upgrade Roundcube database structure by importing shipped SQL file: | ||
| - | {{<pre> | + | {{cmd|<pre> |
# cd /usr/share/apache2/roundcubemail-0.7.1/ | # cd /usr/share/apache2/roundcubemail-0.7.1/ | ||
# mysql -uroot -p | # mysql -uroot -p | ||
| Line 65: | Line 65: | ||
* 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: | * 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: | ||
| - | {{<pre> | + | {{cmd|<pre> |
# cd /usr/share/apache2/ | # cd /usr/share/apache2/ | ||
# chown www-data:www-data config/* | # chown www-data:www-data config/* | ||
| Line 71: | Line 71: | ||
* After Roundcube installer finished upgrading process, disable installer in config file 'config/main.inc.php' by updating below parameter: | * After Roundcube installer finished upgrading process, disable installer in config file 'config/main.inc.php' by updating below parameter: | ||
| - | {{<pre> | + | {{cmd|<pre> |
$rcmail_config['enable_installer'] = false; | $rcmail_config['enable_installer'] = false; | ||
</pre>}} | </pre>}} | ||
That's all. | That's all. | ||
Revision as of 08:28, 19 February 2012
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.
| Terminal: |
# 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 :
| Terminal: |
# ---- 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:
| Terminal: |
# 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:
| Terminal: |
# 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:
| Terminal: |
$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:
| Terminal: |
date.timezone = "Europe/Paris" |
- Restart Apache web server if you have new required packages or PHP modules installed:
| Terminal: |
# /etc/init.d/apache2 restart |
- Upgrade Roundcube database structure by importing shipped SQL file:
| Terminal: |
# 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:
| Terminal: |
# 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:
| Terminal: |
$rcmail_config['enable_installer'] = false; |
That's all.
