Thursday, February 12, 2009 - 09:24
Written by

The second BETA release of version 2.2 - including CiviCase, Personal Campaign Pages, Soft Credits, Multi-value Custom Fields and more - is now available for download. This release includes approximately 20 bug fixes, as well as some improvements in the personal campaign page and custom data / multiple records features. It also includes two new hooks for developers (CRM-4105 and CRM-4094).

You can use the automated upgrade script to upgrade from 2.1.x OR from any previous 2.2 alpha or 2.2 beta 1. This release will be fully upgrade-able to any additional beta versions as well as 2.2 stable. Please help ensure a quality stable release by downloading and testing 2.2 beta against a copy of your site and data.

... If this is your first look at 2.2, check out the 2.2 Roadmap for a good overview. Or you can review a compete listing of new features, improvements and bug fixes on the issue tracker.



You can download CiviCRM 2.2 Beta at the "civicrm_latest" download page. The filenames include the 2.2 Beta label: civicrm-2.2.beta…. Be sure and download the correct version for your CMS (Drupal or Joomla). For standalone installs, download the Drupal version. System requirements for 2.2 are the same as for 2.1: PHP 5.2.x, MySQL 5.x with INNODB enabled, Drupal 6.x OR Joomla 1.5.x.


New 2.2 Installations

If you are installing CiviCRM 2.2 from scratch, use the installation instructions linked below:


Upgrading from 2.1.x OR from 2.2 Alpha

If you are upgrading an existing 2.1 site (working with a copy of the site, of course) or a 2.2 Alpha site, we have provided a browser-based database upgrade script. Test-driving the upgrade process with a copy of your live data is a great way to increase your karma. You help both your organization / clients AND the project as a whole by uncovering any issues with the upgrade - and the team will do our best to help you diagnose and fix any problems. We will continue to provide an easy to run browser-based upgrade, so you can easily upgrade your test site over the course of the 2.2 release cycle (beta -> stable).

The upgrade process for Joomla installs has changed starting with this release. You no longer need to UNINSTALL CiviCRM using the Joomla Extension Manager before installing a new version or revision. Using the Extension Manager UNINSTALL function WILL DELETE ALL CiviCRM TABLES AND DATA.

Detailed instructions for upgrading are here:


Reporting Issues and Bugs

We look forward to getting your feedback on the release in the coming days. If you have questions installing, upgrading and / or using 2.2 features - or you're seeing a problem and you're not sure if it's a bug - please post your issue to the 2.2 release testing section of the community forums. Include as many specifics as possible about the issue or question.

Bugs should be reported via our issue tracking system. Please select 2.2 in the ‘Affects Version’ dropdown. You will need to register as a user – this ensures that we can follow-up with you on your bug reports if necessary. Please ensure that the bug you’ve found is not reported already by checking the open issues listing.


I just wanted to point out that the alternative installation process for Joomla! (sans zip) is supported by the package in SourceForge (simpler than editing scripts)

(PS - sorry if this comment is in the wrong place, but I couldn't add a comment on the Wiki)
(PPS - thanks for supporting those of us who are zip-challenged)

Based on our latest testing, the alternative installation process for Joomla! with does NOT work for upgrades (because existing directories / files are NOT overwritten with new codebase files). We haven't found a nice solution for this yet :-(

We'll probably need to go back to the UNINSTALL first, then INSTALL procedure (for folks who are 'zip challenged'). If you're updgrading using beta 2 - and get the zip error shown below - you will need to wait for beta 3. There is no way to use beta 2 for an upgrade.

"Your PHP version is missing zip functionality. Please ask your system administrator / hosting provider to recompile PHP with zip support."

Do NOT run UNINSTALL for an upgrade with civicrm 2.2 beta 2, as this will delete all your CiviCRM tables. The destructive uninstall will be removed in the next release (beta 3).