Upgrading Active Collab

Starting from version 5.5, Active Collab can be updated automatically from the System Settings. Whenever the button New Update Available appears, click it to apply the latest update.

Upgrading Manually #

If you're having issues with the automatic upgrade or your server has limited internet conectivity, you can also upgrade Active Collab manually:

1

Go to my.activecollab.com/licenses and download the latest version.

2

Unpack the ZIP archive.

3

Upload the folder /5.x.x ("x" are version numbers) from the package to the /activecollab folder of your Active Collab installation (put it right next to the folder of your current version).

4

Open the command line and cd to the /tasks folder on your server.

5

Run this command:

php activecollab-cli.php upgrade --dont-download-latest
6

Delete everything (except the .htaccess file, if you have it) inside the /compile and /cache folders.

Upgrading from Active Collab 4 #

Upgrading the self-hosted version isn’t direct or automatic, but it's not too complicated. You'll have to set up the new Active Collab separately from your existing installation - and then import the data. Just make sure they're both on the same server.

The good part is you can have both versions running side by side. That means you'll still be able to use your old Active Collab while you're installing and testing the new version.

If you have Active Collab v3 or earlier, you first need to upgrade to v4 and then to v5.

Keep a few things in mind:

  • You can only move your data to the new version (and not vice versa).
  • Partial migration is not possible (eg. having only some projects moved to the new version).
1

Make sure you're running Active Collab 4.2.17 or later (learn more).

2

Do a clean install of Active Collab 5 to a separate location (here's how).

3

Check that the AC5 database user has permissions to the AC4 database as well.

4

SSH to your server, navigate to the /tasks folder of your Active Collab 5, make sure that config.php is writable, and run this command:

php activecollab-cli.php clone_legacy_data /path/to/activecollab-4/config/config.php
5

To rebuild the activity logs, run this command:

php activecollab-cli.php rebuild_activity_logs
6

To rebuild the search index, run this command:

php activecollab-cli.php rebuild_search_index

Steps #3, #4 and #5 can take a while, especially if your Active Collab 4 has a lot of data.

After you've upgraded, head off to the Active Collab 5 login page, and enter your Active Collab 4 username and password. All your projects should be there and you'll be able to continue where you left off.

Upgrade Errors

If you’re having trouble, it’s possible you have more than one PHP extension installed on the server (eg. php, php5, phpcli).

It's possible your PHP is not CLI or the version is lower than PHP 5.6.:

  • to check the version, run php -v (or php5 -v depending on the name of extension).
  • find all the extensions by running whereis php

If no PHP extension on your server meets the requirements, you’ll need to install it before the upgrade.

If you find a PHP extension (CLI + PHP5.6) that's called php-cli (eg. under usr/local/bin/), then you’ll need to run the upgrade this way:

usr/local/bin/php-cli activecollab-cli.php clone_legacy_data /path/to/activecollab-4/config/config.php

If you're having difficulties, reach out to support@activecollab.com and we'll help you out.