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.
If you're having issues with the automatic upgrade or your server has limited internet conectivity, you can also upgrade Active Collab manually:
Go to my.activecollab.com/licenses and download the latest version.
Unpack the ZIP archive.
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).
Open the command line and cd to the
/tasks folder on your server.
Run all the required database migrations and upgrade your
/config/version.php file by running:
php activecollab-cli.php upgrade --dont-download-latest
Delete everything (except the .htaccess file, if you have it) inside the
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:
Make sure you're running Active Collab 4.2.17 or later (learn more).
Do a clean install of Active Collab 5 to a separate location (here's how).
Check that the AC5 database user has permissions to the AC4 database as well.
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
To rebuild the activity logs, run this command:
php activecollab-cli.php rebuild_activity_logs
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.
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.:
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 firstname.lastname@example.org and we'll help you out.