Community  »  Applications  »  Gollem

Upgrading Gollem

Contact: gollem@lists.horde.org

1   General instructions

These are instructions to upgrade from earlier Gollem versions. Please backup your existing data before running any of the steps described below. You can't use the updated data with your old Gollem version anymore.

Upgrading Gollem is as easy as running:

pear upgrade -a -B horde/gollem

If you want to upgrade Gollem with all binary dependencies, you need to remove the -B flag. Please note that this might also try to install PHP extensions through PECL that might need further configuration or activation in your PHP configuration:

pear upgrade -a horde/gollem

If you want to upgrade to an alpha or beta version of Gollem, you need to tell the PEAR installer to prefer non-stable package versions. Please note that this might also install pre-release 3rd-party PEAR packages:

pear -d preferred_state=alpha upgrade -a horde/gollem

If you want to upgrade from an Gollem version prior to 2.0, please follow the instructions in INSTALL to install the most recent Gollem version using the PEAR installer.

After updating to a newer Gollem version, you always need to update configurations and database schemes. Log in as an administrator, go to Administration => Configuration and update anything that's highlighted as outdated.

2   Upgrading Gollem From 2.x To 3.x

This is a non-exhaustive, quick explanation of what has changed between a Gollem 2.x installation to Gollem 3.x.

2.1   File sharing

File sharing support has been added and is enabled by default for the "file" and "sqlhome" backend configuration examples.

File sharing allows more flexible sharing of folders between Horde users and groups, independent from the backend's permission system. To correctly work it actually needs a backend type that does not enforce per-user permissions.

See the comments for the "shares" parameter in backends.php for details.

3   Upgrading Gollem From 1.x To 2.x

This is a non-exhaustive, quick explanation of what has changed between a Gollem 1.x installation to Gollem 2.x.

3.1   MIME Viewer Options (mime_drivers.php)

Gollem specific MIME configuration is no longer needed, so this configuration file can be removed.

3.2   Server Options (backends.php)

The 'clipboard' option has been removed. The availability of the clipboard is now entirely dependent on the user's edit permissions for the application.