Manual upgrade from the Tarball

We strongly recommend that you use our Debian packages or Docker instead of the tarball. But if you really want use it then follow these steps:

  1. Grab the version to install from https://github.com/Intermesh/groupoffice/releases

  2. Make sure your system meets the System requirements.

  3. Make sure you’re on the latest minor release of your current version (For example 6.2.112 or 6.3.76).

  4. When running 6.2 make sure you’ve installed the “customfields” and “search” modules as they will become part of the Group-Office core.

  5. If you are coming from version 5.0 or lower. Then you must install the projects2 module in 6.2 to migrate your existing data. This can’t be done in a later version!

  6. Move away your old source files to a backup location.

    Warning

    Do not copy the new files over the existing. This will result in a broken system.

  7. Put the new files at the right location.

  8. If exists copy your old config.php and license file to the new files. It is good practice to keep these files one directory higher then the Group-Office source so you have a complete clean code base.

  9. Visit http://yourdomain/install/ and follow instructions.

  10. Check if you have the right cron job in place:

    * * * * * www-data php <YOURDOCUMENTROOT>/cron.php

Note

If you’re upgrading from 6.2 to 6.3 or higher and you are running the CGI version of PHP then you need to add a reqrite rule to add the “Authorization” header. Read more at Authentication with CGI or FastCGI.

Registering a license

When upgrading from 6.4 to 6.5, you may run into a licensing issue.

Since 6.5, it is possible to install or reinstall a license from within Group Office itself, so you do not need to download the license file anymore. Make sure that you are logged as an administrator, click on the menu and select ‘Register’.

../_images/registration.png

Registration screen

Click the ‘Get license now’ button, log in to the Group Office website, find your license key and paste it in the text box.

Update script

I’ve written a simple bash script that downloads the latest PHP 7.1+ version of Group-Office and replaces all code in the given directory.

You can run it like this:

./update-groupoffice.sh <DIR_OF GROUPOFFICE>

Warning

Please backup before using!

#!/bin/bash
set -e

TARGET=$1

if [ ! -d "$TARGET" ]; then
    echo "$TARGET doesn't exist!"
    exit 1;
fi

if [ ! -f "$TARGET/version.php" ]; then

    echo "$TARGET is not a Group-Office directory!"
    exit 1
fi

read -r -p "Are you sure you want to update directory '$TARGET'? [y/N]" response;
if [[ "$response" != "y"  ]]; then
    exit 0
fi

mkdir -p goupdate
cd goupdate
rm -f download
wget https://sourceforge.net/projects/group-office/files/latest/download
tar zxf download

GO=`ls | grep groupoffice`
echo $GO

cd $GO

for f in *; do
    rm -rf ../../$TARGET/$f
    cp -a $f ../../$TARGET
done

cd ../../