Table of Contents

Upgrading Drupal

Because FIS’s instance is a multisite, our standard upgrade procedures need slight modification. Once you have reviewed the client manifest and verified that no customizations will break from a standard upgrade, follow these steps to upgrade Drupal modules (including core):

  1. Put all the sites in maintenance mode, then clear all their caches:

    $ drush -y @sites vset --exact maintenance_mode 1
    $ drush -y @sites cc all
  2. Backup the files and databases for the instance that is to be upgraded. Be sure to keep copies of .htaccess and robots.txt easily accessible. Drupal core upgrades will overwrite these, and you’ll need to replace customizations post-upgrade. Copying them to the conf directory, a sibling of htdocs, is a good idea.

  3. Upgrade the desired modules. In this example, we’re upgrading just core. This step will download the files, which only needs to be done once, then run the database upgrades for the default site only: $ cd /path/to/webroot/sites/default $ drush -y up drupal

  4. Run the database upgrades for all sites: $ drush -y @sites updb

  5. Compare the new .htaccess and robots.txt files with your backups. Restore any customizations that were overwritten.

  6. Take the sites out of maintenance mode: $ drush -y @sites vset --exact maintenance_mode 0 $ drush -y @sites cc all