Upgrading CiviCRM to Version 1.9 on Joomla!

We strongly recommend that you do a test run on a test server before trying this on a production site.

1. Verify that your server/host is running PHP 5.x. CiviCRM 1.9 is not compatible with earlier versions of PHP (4.x or lower).
2. Make a copy of your website and your database and ensure that it is a valid working copy. For simplicity make sure you have easy access to both copies of civicrm.settings.php as you will need to reference them later.
3. Uninstall CiviCRM using the component uninstaller.
4. Download the v1.9 CiviCRM Package from SourceForge. Select the Joomla compressed downloads. EXAMPLE: Select civicrm-1.9.xxxxxx-joomla-php5.zip
5. Upload this file to your server in your home directory and unzip it. Let's call this location HOME. Ensure that this is in a different directory from your Joomla! installation directory (lets call this JOOMLA_ROOT). You should now have a com_civicrm directory in your HOME directory with lots of sub-directories and files below it.
6. Edit the file HOME/com_civicrm/configure.php and make the following change on line 10.

   Data Loss Warning Updating configure.php as shown below is critical. Make sure you find the right file and save the change. Otherwise, your existing CiviCRM data will be over-written.

   configure.php

   // Change this line:
   
   $civicrmUpgrade = false;
   
   // To this:
   
   $civicrmUpgrade = true;

7. Install the latest CiviCRM codebase, using the Install from Directory option. Point it to the directory HOME
8. Upgrade the database using the sql script provided under:

   HOME/com_civicrm/civicrm/sql/civicrm_upgradedb_vOLD_vNEW_41.sql

   vOLD = Old CiviCRM version
   vNew  = New CiviCRM version

9. Delete the files in

   JOOMLA_ROOT/media/civicrm/templates_c

   and

   JOOMLA_ROOT/media/civicrm/upload

10. Delete all session files wherever they are located. You can use a debug tool to achieve both this and step 7, refer to Installation and Configuration Trouble-shooting
11. Update both copies of the new civicrm.settings.php file with any changes that you made in the prior version of civicrm.settings.php file (e.g. Paypal settings, Enable CiviContribute, etc.). Joomla installations use two separate settings files - one in JOOMLA_ROOT/components/com_civicrm for front-end pages, and one in JOOMLA_ROOT/administrator/components/com_civicrm.
12. You should be up and running with the latest CiviCRM version. Confirm by checking the footer at each page.
13. Recreate any Joomla menu links to Profiles, Contribution Pages or Events.
14. Re-configure Payment Processor and Contribution / Event Registration Pages

    This Step is Required for Sites Using Online Contribution Pages, Membership Signup or Event Registration The method for storing Payment Processor configurations has changed from CiviCRM 1.7 to 1.8. If you are using CiviContribute to collect online contributions OR membership signup and/or using CiviEvent for online event registration - you must follow the steps below.

• Re-enter your Payment Processor information:
  • Login with administer CiviCRM permission
  • Go to *Administer CiviCRM » Global Settings » Payment Processors* (the page will say that "There are no Payment Processors entered.")
  • Click add one
  • Select the Payment Processor Type corresponding to the one you have been using in 1.7 (e.g. PayPal - Website Payments Pro)
  • Enter the required account information for your selected processor (e.g. User Name, Password, etc.). As of 1.8 ALL processor configuration information is entered from this screen. You no longer need to enter or edit payment processor passwords, signature values etc. in civicrm.settings.php.
  • Click Save

• Link your re-entered Payment Processor to each of your existing Online Contribution and Event Registration pages
  • Go to *Administer CiviCRM » Manage Contribution Pages*
  • Click Configure
  • Click Title and Settings
  • Your newly entered Payment Processor should be selected in the Payment Processor field
  • Click Save (This is important - the link between the contribution page and the payment processor is not created until you hit Save on this screen.)
  • Repeat these above steps for each active Online Contribution page on your site...
  • Go to *Administer CiviCRM » Manage Events*
  • Click Configure
  • Click Event Fees
  • Your newly entered Payment Processor should be selected in the Payment Processor field
  • Click Save (This is important - the link between the registration page and the payment processor is not created until you hit Save on this screen.)
  • Repeat these above steps for each active Event Registration page on your site...

    Additional Locations The number of locations/addresses shown on the contact editing screen is now controlled from Global Settings » Address Settings. The default value after upgrading is 1. If you want 2 or more locations to available when adding new contacts - you'll need to modify the Number of Locations value.

1. If you use the UpdateMembershipRecord.php cron then please note that this will have been replaced with bin/UpdateMembershipRecord.php.txt - see http://wiki.civicrm.org/confluence/display/CRMDOC/Membership+Types for details.

Related Resources

Install 1.9 for Joomla
Configuring Front-end Profile Listings and Forms in Joomla! Sites
Displaying Online Contribution Pages in Joomla! Frontend Sites