How to Upgrade Roundcube

Roundcube is being maintained via git on stallman.mayfirst.org in the /srv directory.

We have both a dev/testing site (/srv/roundcube-dev, accessible via ​https://roundcube.dev.mayfirst.org) and the live site (/srv/roundcube, accessible via ​https://roundcube.mayfirst.org).

Both installations are maintained via git. In addition, there is a roundcube-code user that owns the code.

Basic Setup (only needed once)

Create a roundcube directory on your local machine, initialize git and set your various remotes:

git clone https://github.com/roundcube/roundcubemail roundcube
cd roundcube
git remote add gmo git://git.mayfirst.org/mfpl/roundcube
git config remote.gmo.pushurl ssh://gitolite3@git.mayfirst.org/mfpl/roundcube
git remote update

Create a target branch for the upgrade

The idea is to create a new branch for us - that is based on the target version of roundcube to which we are upgrading.

In other words, if we want to upgrade to roundcube 1.4.13:

0 jamie@animal:roundcube$ git checkout -b mfpl-1.4.13 1.4.13
Branch mfpl set up to track remote branch mfpl from gmo.
Switched to a new branch 'mfpl-1.4.13'
0 jamie@animal:roundcube$

Doing an upgrade

Note: Firt do everything in the dev directory as the roundcube-dev user. After testing, repeat for the live site.

USER=roundube-dev
DIR=/srv/roundcube-dev
DATABASE=roundcube-dev

# run the gc script, so there's no need to backup old session records
su - $USER
cd $DIR
php ./bin/gc.sh

# backup database 
cd /home/$USER
pg_dump -v -b -C DATABASE | gzip -9 > roundcube.$(date +%F).sql.gz

# fetch source (as user `roundcube-code')
su - roundcube-code
cd $DIR
git fetch gmo
git checkout TAG
# composer updates
composer update --no-dev
# if you get a giant error...
# rm vendor/composer/installed.json
# See https://craftcms.stackexchange.com/questions/36551/unknown-package-has-no-name-defined-composer-error-on-upgrade
composer install --no-dev
# javascript dependencies
php bin/install-jsdeps.sh
lessc -x styles/styles.less > styles/styles.css
lessc -x styles/print.less > styles/print.css
lessc -x styles/embed.less > styles/embed.css
su - $USER
# database stuff (as user roundcube)
php ./bin/update.sh
php ./bin/indexcontacts.sh