|Use this document to UPGRADE CiviCRM installations on Wordpress to the latest 4.3 release from 4.1.x, 4.2.x or an earlier 4.3 version.|
- Installing from scratch? Use the installation instructions for WordPress
IMPORTANT: These instructions are for sites using or upgrading to WordPress only.
|Version 4.3 Requirements|
Before beginning this upgrade, verify that your server meets the requirements for CiviCRM 4.3
- WordPress 3.4+ : CiviCRM 4.3 is built to run under WordPress 3.4+ and is not compatible with earlier WordPress versions.
- PHP 5.3.3+ (more info...).
- MySQL 5.0.x or higher with InnoDB support : CiviCRM is compatible the current generally available MySQL release. Note that MySQL 5.1 is recommended for new installations and for sites during upgrades as CiviCRM is beginning to use Triggers more (eg to support multi-lingual installations), which require SUPER privileges in MySQL 5.0.
- PCRE with Unicode properties support (more info).
|Upgrade a Copy of Your Site First and Make a Complete Backup|
We strongly recommend that you create a copy of your existing site (directories and database) - and upgrade that copy first in order to make sure you can complete the upgrade successfully. In any case, you should create a full backup of the installed civicrm directory tree and civicrm database before beginning the upgrade process. Note that not all versions of mysql or phpmyadmin export triggers or stored procedures by default.
If you are upgrading a COPY of your production site - make sure the site you are about to upgrade is a fully functioning installation before you begin the upgrade process. (more info...)
|System Administrator Alert|
All Cron Jobs Must be Re-configured
- Upgrades from 4.1.x and prior: All CiviCRM-related cron jobs will stop working as soon as any site is upgraded from 4.1.x and below. If you are upgrading from a version prior to 4.2, cron jobs will need to be reconfigured using the new Scheduled Jobs method.
- Upgrades from 4.2.x: If you are running scheduled jobs using CLI.php, you will need to reconfigure cron to include a password. Scheduled jobs will no longer run if the password is not provided (learn more).
Step-by-step Upgrade Procedures
1. Download the most recent CiviCRM Package
2. Backup your CiviCRM database and settings file
Refer to the MySQL reference manual or the phpMyAdmin documentation if you need information on backing up your database. Note that not all versions of mysql or phpmyadmin export triggers or stored procedures by default.
Make a backup/copy of civicrm settings file:
- <wordpress_root>/wp-content/plugins/civicrm/civicrm.settings.php.(this would be useful for relocating)
CiviCRM will not run properly if files from previous version are present after the upgrade. Make sure you have a good backup of your complete previous version installation and then delete /wp-content/plugins/civicrm.
Make sure you have logged in to Wordpress BEFORE deleting the old files. Do not log out until the entire process is complete.
3. Unpack the latest package and relocate settings file
Unpack the files into <wordpress home>/wp-content/plugins/.
- Relocate (paste) the backed-up civicrm.settings.php file(in step 2) inside <wordpress home>/wp-content/plugins/civicrm/
If you have upgraded from a CiviCRM 4.1 version, check the contents of civicrm.settings.php. Make sure at the very end of the file these 2 lines exist, and if not, add them.
4. Run the Upgrade script
This step is required for ALL upgrades.
|MySQL 4.0 and 4.1 are Not Supported|
Support for MySQL versions 4.0 and 4.1 has been discontinued. This means that you may encounter various issues and/or unexpected behavior if you attempt to run CiviCRM under these versions, and the CiviCRM engineering team will not provide support for debugging or resolving these issues. You are strongly encouraged to upgrade to the current generally available release of MySQL.
* Point your web browser to the following URL (you should already be logged in to Wordpress with administrator-level permissions):
- You should see the Upgrade screen.
- If you are ready to upgrade, click the Upgrade Now button.
- You should see the message Upgrade successfulwhen the upgrade completes.
- If you receive any errors during the process, please note down the exact error message, and check for solutions on the community support forum.
- Now click the Return to CiviCRM home page link. This will rebuild CiviCRM menus automatically and return you to the CiviCRM home dashboard.
5. Verify and Update Resource URL Settings
- Go to Administer » System Settings » Resource URLs
- Refer to the field help on that screen for instructions.
6. Enable Components
If you plan on using the new CiviCase component, or any components that you weren't using in the prior version (e.g. CiviPledge or CiviGrant for grant management) - you'll need to enable these component(s):
- Go to Administer » System Settings » Enable CiviCRM Components
Check this section for answers to upgrade problems. If your problem isn't addressed here, check out the Installation and Configuration Trouble-shooting page for additional resources.
You do not have sufficient permissions to access this page.
If you get this error when trying to run the upgrade script(step 4), you most likely deactivated CiviCRM plugin during the upgrade process. You just have to visit <wordpress_home>/wp-admin/plugins.php and activate the plugin, and then proceed with step 4 .
Reset Your User Session
If you are getting foreign key constraint errors when trying to add or modify records, you may need to reset your user session.
- Temporarily enable CiviCRM debug features:
- Go to Administer CiviCRM » System Settings » Debugging and Error Handling
- Set Enable Debugging to Yes and click Save.
Click the Administer CiviCRM menu (or any other CiviCRM menu item). After the page is loaded, add an additional query string value (sessionReset=2) to the URL in your browser's location bar, and reload the page.
Now reset Enable Debuggingto No and click Save.
|Do Not Leave Debug Features Enabled for a Public Site|
Debugging should be disabled for publicly available sites as it may allow browsers to view system configuration information.
Verify and Update Base Directory and Base URL Settings in the Database
If you are seeing problems with missing images or page styling, you may need to adjust the Base Directory and Base URL Settings in the database. You can do this from:
Administer CiviCRM » System Settings » Cleanup Caches and Update Paths
Foreign Key Errors or Warnings During the Database Upgrade
Foreign keys may have been assigned different names on some installations. Also, different versions of MySQL handle the dropping and adding of constraint checks differently. Try this procedure or this procedure (on the forum) to reload your data into a new 4.0 database structure if you are having this type of issue with upgrading your database.
Download and run Database Troubleshooting Tools to test the current state of the database and provides a diagnosis. The tools suite also includes a repair facility.
The menus are wrong, the admin dashboard does not have the correct links and settings, or get an error with CRM_Core_Invoke::require_once()
You can re-build the menu/admin dashboard by visiting the following url - (http:///wp-admin/admin.php?page=CiviCRM&q=civicrm/menu/rebuild&reset=1 (http://%3cdomain%3e/civicrm/menu/rebuild?reset=1))