Managing the codebase

Attention!

You should never update drupal core without applying patches to it first, as this will likely break your site.

Updating existing installed instances of UA Quickstart

There are a few ways to update your quickstart site to the latest version depending on your hosting environment. 

Campus Web Services maintains an upstream of Quickstart on Pantheon. This is a managed hosting environment and eliminates much of the system administration work required to host a Drupal site and frees you up to do more development-oriented work. One key feature of hosting on Pantheon is you can track our custom Drupal distribution as an ‘upstream’ and deploy updates with a single click.

  1. Log in to the Pantheon dashboard for your site.
  2. In the Dev environment, click Apply Updates.
  3. In the Test environment, click Deploy Code from Development to Test Environment. 
  4. Review your site in the Test Environment.
  5. In the Live environment, click Deploy Code from Test to Live Environment.

For more on this process, review the Pantheon Workflow Documentation

  1. Download a built copy of the most recently tagged release from bitbucket.
  2. Extract the archive. This will create a directory named `ua_quickstart`. This directory contains all the updated Drupal core files and the associated UA QuickStart modules.
  3. Your site’s custom code and files will likely be stored in a path such as ‘~/public_html/sites’. The goal here is to replace all the files in ~/public_html except for the `sites` directory which contains your site’s custom code. You can do this however you’d like, but it’s probably a good idea to make an archive/backup of your ‘public_html’ (or whatever your webroot is) in case something goes wrong and you need to revert to the pre-update state.
  4. After the code has been replaced, you’ll want to make an SQL dump backup of the database in use by Drupal.
  5. After creating this backup, you can visit <your-site.>arizona.edu/update.php to run database updates for your site. This will ensure your database is brought into the correct state to be used with the new code you’ve added.

A complete overview of methods for updating Drupal core can be found here: https://www.drupal.org/docs/7/update

There is a command line tool developed for Drupal administration called ‘Drush’ which will probably make some of your administration tasks such as backups easier, but keep in mind that it shouldn’t be used to automatically update Drupal core since you are using a custom distribution (UA QuickStart).

We highly suggest putting your site under version control with git. Doing this makes it easy to revert code changes if needed and to easily see what things have been changed when you do updates.

Compile Quickstart with drush make and replace existing codebase.  This can be scripted and is the preferred method if not on Pantheon. advanced

This is usually done using the Drush Symlink Manager (DSLM) and the dslm project on Drupal.org documents it pretty well.