Skip to content

Latest commit

 

History

History
57 lines (44 loc) · 2.38 KB

UPDATE.md

File metadata and controls

57 lines (44 loc) · 2.38 KB

This file contains instructions for updating your PCO CITIES-based Drupal site.

PCO CITIES has a two-pronged update process. Out of the box, it provides a great deal of default configuration for your site, but once it's installed, all that configuration is "owned" by your site and PCO CITIES cannot safely modify it without potentially changing your site's behavior or, in a worst-case scenario, causing data loss.

As it evolves, PCO CITIES's default config may change. In certain limited cases, PCO CITIES will attempt to safely update configuration that it depends on (which will usually be locked anyway to prevent you from modifying it). Otherwise, PCO CITIES will leave your configuration alone, respecting the fact that your site owns it. So, to bring your site fully up-to-date with the latest default configuration, you must follow the appropriate set(s) of instructions in the "Manual update steps" section of this file.

Updating PCO CITIES

Composer

If you've installed PCO CITIES using our Composer-based project template, all you need to do is:

  • cd /path/to/YOUR_PROJECT
  • composer update
  • Run drush updatedb or visit update.php to perform db updates.
  • Perform any necessary manual updates (see below).

Tarball

Do not use drush pm-update or drush up to update PCO CITIES! PCO CITIES includes specific, vetted, pre-tested versions of modules, and occasionally patches for those modules (and Drupal core). Drush's updater totally disregards all of that and may therefore break your site.

To update PCO CITIES safely:

  1. Download the latest version of PCO CITIES from https://github.com/pco-bcp/pco_cities and extract it.
  2. Replace your profiles/pco_cities directory with the one included in the fresh copy of PCO CITIES.
  3. Replace your core directory with the one included in the fresh copy PCO CITIES.
  4. Visit update.php or run drush updatedb to perform any necessary database updates.
  5. Perform any necessary manual updates (see below).

Manual update steps

These instructions describe how to update your site's configuration to bring it in line with a newer version of PCO CITIES. These changes are never made automatically by PCO CITIES because they have the potential to change the way your site works.