Upgrading from activeCollab v0.7.1

activeCollab 0.7.1 and activeCollab v2.x are entirely different systems and so a direct upgrade is not possible. Due to the incompatibility of the Importer module with activeCollab v2.x, the data from activeCollab v0.7.1 first needs to be imported into v1.0.6. After you have import your data into this version of activeCollab, you can then upgrade to the latest release.

Here's what you need to do to get from activeCollab 0.7.1 to activeCollab 2.x:

Move Files from the Database to the File System

By default, activeCollab 0.7.1 stores files in the database. In order to move them to activeCollab 1.0, they need to be available on the file system. We have provided a script that can move them for you, just follow these steps:

  1. Download the blob2fs.php conversion script;
  2. Unpack the archive and upload blob2fs.php to the /upload folder of your activeCollab 0.7.1 setup;
  3. Visit /upload/blog2fs.php using your web browser and let it run until it shows a message that all files have been moved.
Note

blob2fs.php tool moves 1 file per second. When a file is moved, the page will refresh and start moving the next file. This way the large files can be moved without causing memory problems.

Download and Install activeCollab v1.0.6

You can download activeCollab v1.0.6 from your www.activeCollab.com profile page, it will be available in the Additional Downloads section:

Once you've downloaded it you can install it using the installation instructions in this article.

Install Importer Module

Download the Importer module and install it as follows:

  1. Unpack the module's archive;
  2. Upload the contents of application.zip to /activecollab/application/modules;
  3. Upload the contents of assets.zip to /public/assets/modules;
  4. Go to Admin -> Modules in your copy of activeCollab and click Install next to the Importer Module's name.

Import Companies and Users

Once the Importer Module is installed, you will find it under Administration > Tools. Start by importing Companies and Users. Click the Companies and Users icon, insert connection parameters for the activeCollab 0.7.1 database and click the Submit button.

Import Project Data

After you have imported Companies and Users, you can start moving your project data from the old setup. To do this click the Projects, Milestones, Tasks... link and provide connection parameters for the old activeCollab database.

Note: You will need to provide the full path to the folder where the old activeCollab files are located. To find out the exact location of the /upload folder in the activeCollab 0.7.1 setup, create a path.php file with the following content:

<?php print dirname(__FILE__); ?>

and save it to the /uploads folder. Then, open it using your web browser and the exact path will be displayed.

Important!

The import process can consume a lot of resources, so we don't recommend importing all your projects at once. Instead of importing all of them at the same time, try to import five or less projects at a time. If you receive 'max execution time' or 'memory limit' errors, try importing fewer projects per cycle.

Note

Importer does not remember which projects were imported and so it always shows the full list of available projects.

Uninstall Importer Module

After you finish importing data from the old setup, uninstall and remove the Importer Module because it will cause errors when you upgrade to v2.x.

Upgrade to activeCollab v2.x

Upgrading to the latest release is the final step and the whole process is described at this article.