RMacD.com

Introduction

RoundCube is an AJAX based web mail email client, which supports address books, LDAP searches, spellchecking, RSS and many more features in a very sleek interface. Installing RoundCube is a breeze, but here's a quick guide on how to upgrade from the Beta 2 release.

Before you start

All the files in the /skins/default directory are overwritten in this upgrade. Make sure you back up any changes you have made to these files, which control the display and layout of the email client's interface.

Also, be sure to thoroughly read the information in the README file, as well as the UPGRADE file before you install or upgrade RoundCube. This saves a lot of time in the long run, as it helps you understand what needs to be done before the program will run 'out of the box'.

Back up your files

For the time it takes, be sure to keep a copy of your original RoundCube installation, in case anything mucks up. In any case, this can be used to resore your configuration. Better still, set up RoundCube in a separate directory, under another Virtual Host, and be sure everything's working exactly as you expect, before you release your upgraded interface.

Backing up your files is easy, simply cd to the parent directory of your RoundCube installation and process the commands as follows:

# tar -cf roundcube.tar [name of your roundcube folder]
# gzip roundcube.tar

The output file should be called roundcube.tar.gz.

Download the source

The source is available for download at SourceForge.net - download v0.1-rc1 here.

Unzip and unpack:

# tar -zxvf roundcubemail-0.1-rc1.tar.gz
# cd roundcubemail-0.1-rc1

Now's your chance to read up on the documentation:

# vi UPGRADING

Upgrading

Updating the files

Here's the fun bit!

Let's follow the UPDATE documentation, shall we?

Firstly, replace your current index.php with the new version:
[Assuming your current RoundCube installation and the unzipped package share a common parent directory]
# mv index.php ../roundcube/

and now we're going to move the core program files
# mv program/ ../roundcube/

as well as the layouts and designsThursday, 25 October, 2007

Upgrading the Database

Be careful here - you don't want to be messing with the database unless you're VERY sure what you're doing. If in any doubt, read the README provided with the RoundCube package.

Assuming you've preserved the standard database layout:
# mysql -u [roundcube_user] -p [database_name] < SQL/mysql.update.sql
# Enter Password:

And you're almost there!

Altering a couple of files

Open /config/db.inc.php in your preferred text editor and add the following line to the end of the file:
$rcmail_config['db_persistent'] = TRUE;

Now open the file /config/main.inc.php (in the same directory as above) and add the following lines to the end of the file:

$rcmail_config['drafts_mbox'] = 'Drafts';
$rcmail_config['junk_mbox'] = 'Junk';
$rcmail_config['product_name'] = 'RoundCube Webmail';
$rcmail_config['read_when_deleted'] = TRUE;
$rcmail_config['enable_spellcheck'] = TRUE;
$rcmail_config['protect_default_folders'] = TRUE;
$rcmail_config['draft_autosave'] = 300;
$rcmail_config['date_today'] = 'H:i';

Now, in the same file, find the line that reads
@include($_SERVER['HTTP_HOST'].'.inc.php');

and replace this line by
$rcmail_config['include_host_config'] = TRUE;

Happy emailing!