Jump to content

Fundraising/tech/crm/Upgrade CiviCRM

From Wikitech

Upgrading CiviCRM

  • First, make sure you have core set up as a git repo within your wmf. If you don't have it yet
cd core && git init && git remote add origin https://github.com/civicrm/civicrm-core
  • Then pull in the relevant branch
git fetch origin 6.nn & git reset --hard origin/6.nn
  • Then from wmf
git add core
  • Now you should see the changes in you main wmf repo. You may need to adjust PHPStorm settings to unregister the directory mapping for core.
  • You'll have to do the same for core/packages for updates to civicrm-packages using https://github.com/civicrm/civicrm-packages.git (you'll need to do this because packages if git ignored in core (and we don't want those _ORIGINAL_ copies)
rm -rf core/packages/_ORIGINAL_ && git add -f core/packages
  • Commit and git review as normal.

Composer: You may also need to do composer updates, see Fundraising/Cluster/Deployments for details.

Deploying a CiviCRM upgrade

Please note that your particular upgrade may require additional precautions or other action, see the CiviCRM release notes for details.

  • Shut down all process-control jobs which depend on the CRM. Just turn 'em all off if you're feeling lazy.
  • Verify database backups are current.
  • Deploy new wikimedia/fundraising/crm code.
  • Beyond this point, know that you cannot recover safely without doing a full database restore...
  • Run the database updates:
cv updb
  • Turn jobs on again, slowly and carefully.

See also