Upgrading

Backup your data first! Follow the instructions here: Moving or backup an installation

Using the Debian/Ubuntu packages

If you are using the professional version or billing module make sure you download the new 3.7 license files first from https://shop.group-office.com/Download and put them in /usr/share/groupoffice.

Then change /etc/apt/sources.list:

deb http://repos.groupoffice.eu/ threeseven main

into:

deb http://repos.groupoffice.eu/ fourzero main

Then update the package info:

apt-get update

After changing to repository and updating the package list you still have to upgrade your machine, The following command will updgrade all packages you have installated that have new versions available including groupoffice

apt-get upgrade

If you do not want to install all updates available for your machine you can only upgrade the groupoffice packages as well, this is not advised and you also need to know what packages there are installed on your systeem. The following command will install the main groupoffice installation.

apt-get install groupoffice-com

When you are also using other groupoffice packages or the groupoffice-pro package you will have to upgrade these as well.

If you run into an error after upgrading please try to Rebuild the search cache and run the database check at Start menu -> System tools

Upgrading from 3.x to 4.x

To upgrade to 4.x. Your Group-Office version must be at least 3.7.41. If you have an older version, upgrade to the latest 3.7 version first.

SMTP with TLS

For some reason, TLS encryption has changed in the Swift Mailer component. If you get timeouts on the SMTP connection, try to switch TLS to SSL. If this works and you want to change all accounts you can run the following SQL:

UPDATE em_accounts SET smtp_encryption='ssl' WHERE smtp_encryption='tls' AND smtp_host='yourserver';

Ubuntu 12.04

Ubuntu 12.04 comes with dovecot 2.0. The dovecot configuration has changed a lot. The easiest solution is to completely remove dovecot with it's configuration files:

sudo apt-get purge dovecot-core

This will remove groupoffice-mailserver and some other related packages too. Reinstall them afterwards:

sudo apt-get install groupoffice-mailserver dovecot-mysql dovecot-sieve dovecot-managesieved

SyncML

If you use syncml for funambol or synthesis clients. You must install the SyncML module after upgrading. Additionally you must change the sync URL and datastores. For more info see Synchronization client or device setup.

Z-push

If z-push is installed you'll need to upgrade it manually as described at the ActiveSync page.

Billing

In 3.7 the billing module was in the pro package. We have a separate billing package now so if you use that you must run "apt-get install groupoffice-billing" too.

LDAP Authentication

If you use LDAP auth. You must change the following in your mapping:

change:

new ldap_mapping_type('function','some_function')

into:

new GO_Ldapauth_Mapping_Function('some_function')

Also be aware that the parameter is no array but a GO_Base_Ldap_Record object.

and:

new ldap_mapping_type('constant','1')

into:

new GO_Ldapauth_Mapping_Constant('1')

IMAP Authentication

We have removed some parameters from the imapauth.config.php file.

The following parameters are removed (They are not used by Group-Office anymore):

'visible_groups' => array('Everyone', 'Internal'),
'modules_read' => array('email', 'files', 'addressbook', 'calendar', 'tasks', 'notes', 'summary'),
'modules_write' => array()

To give a new imapauth user the correct rights you need to add them to a group and set the correct rights on that group.

So you first need to create a group and set up the correct rights for it. (For example, create the group "imapauthuser").

Then you need to set the following parameter in the imapauth.config.php file:

'groups' => array('imapauthuser')

Manual upgrade

If you are using the professional version download the license file and tarbal packages from https://shop.group-office.com/Download. If you use the Community version download the packages from http://sourceforge.net/projects/group-office/.

Take the following steps:

1. Backup your database
2. Move away your old source files.
3. Put the new files at the right location.
4. If exists copy your old config.php to the new files.
5. Launch Group-Office in your browser and it will perform a system upgrade.
6. If z-push is installed you'll need to upgrade it manually as described at the ActiveSync page.

From the Community to Professional version

If you are using the professional version or billing module make sure you download the license files first from https://shop.group-office.com/Download and put them in /usr/share/groupoffice. Then run:

apt-get install groupoffice-pro

If you are using the tar packages download the package from the shop and replace the files.

After this you can login to Group-Office and install the professional modules at Start menu -> Modules.