Changes between Version 19 and Version 20 of faq/drupal/upgrade


Ignore:
Timestamp:
Nov 7, 2010, 9:31:39 PM (10 years ago)
Author:
chris gang
Comment:

updated to reflect GUI-ified method for updating symlinks, + other small changes

Legend:

Unmodified
Added
Removed
Modified
  • faq/drupal/upgrade

    v19 v20  
    1616
    1717
    18 In addition, these directions are for upgrading from 4.7 to 5, however, they also apply if you are upgrading from 4.6 or from 5 to 6. Please remember - you must upgrade incrementally. In other words, you can't go directly from 4.6 to 6. You must first upgrade from 4.6 to 4.7, and then upgrade from 4.7 to 5 and then from 5 to 6, etc.
     18In addition, these directions are for upgrading from 4.7 to 5, however, they also apply if you are upgrading from 4.6 to 4.7 or from 5 to 6. Please remember - you must upgrade incrementally. In other words, you can't go directly from 4.6 to 6. You must first upgrade from 4.6 to 4.7, and then upgrade from 4.7 to 5 and then from 5 to 6, etc.
    1919
    2020 * Assemble your team. To upgrade Drupal, you will need someone who is comfortable using the command line and using secure shell (ssh). If that is not you, you may want to recruit some helpers.
     
    2424 * Make a list of custom scripts and other special templates you may have in your theme's directory. If you are using Drupal without any customization ("out of the box") with a standard theme (e.g. Bluemarine), your upgrade will go very smoothly. If you have customized scripts and pages, these may break after the upgrade (requiring you to tweak them). If you do have a heavily customized theme, you may consider switching to a core theme before the upgrade. Then, upgrade your theme (there are [http://drupal.org/update/theme notes for doing this on drupal.org]), and finally try switching back to your custom theme.
    2525
    26  * Upgrade all your third party modules to the most recent version. If you are rnning Drupal 5 and upgrading to Drupal 6, ensure all third party modules are at the most recent Drupal 5 version first. You can do this easily with drush. From the command line, in your web directory, type:
     26 * Upgrade all your third party modules to the most recent version. If you are running Drupal 5 and upgrading to Drupal 6, ensure all third party modules are at the most recent Drupal 5 version first. You can do this easily with drush. From the command line, in your web directory, type:
    2727{{{
    28 drush update
     28drush pm-update
    2929}}}
    3030 * Test to make sure your site is still functioning properly before you continue.
     31
    3132 * Make a backup! You will want to backup both your directories and your database. To backup these up, [wiki:secure_shell ssh] into your server and run the following commands (replacing YOURDOMAIN with your actual domain name and YOURDATABASE with the name of your database):
    32 
    3333{{{
    3434cp -r -p YOURDOMAIN/web web.backup
     
    4444 * Using [wiki:sftp secure FTP] or [wiki:secure_shell ssh], rename the modules directory your sites/default/modules directory to modules.d5. Create a new, empty modules directory.
    4545
    46  * Using [wiki:secure_shell ssh], change into your web directory. Replace YOURDOMAIN with your actual domain:
    47 {{{
    48 cd YOURDOMAIN/web
    49 }}}
     46 * Use the members control panel to update the symbolic links in your Drupal root: From your [https://members.mayfirst.org/cp/ member control panel], select the hosting order you want to upgrade, choose the "Web App (Drupal)" tab, and click "edit" next to the Drupal installation you're upgrading. Select the version of Drupal you're upgrading to, and click Submit.
    5047
    51  * Run the mf-change-drupal-symlinks script. Run the following command
    52 {{{
    53 mf-change-drupal-symlinks
    54 }}}
    55 
    56  * Now - your site is using the Drupal 5 code. Next, go to the update.php script on your site. The should be something like: http://example.org/update.php
     48 * Now - your site is using code for the upgraded Drupal version you just selected. Next, go to the update.php script on your site. The should be something like: http://example.org/update.php
    5749
    5850 * Follow the directions for updating your database. Copy and paste all the output in case you run into problems later - it will be useful to reference it.
     
    6052 * Test your site. Remember - your third party modules will not yet be working!
    6153
    62  * One by one, add the drupal 5 version of each third party module to your modules directory (`web/sites/default/modules`) and enable it via Drupal. After enabling each module, return to the update.php script to run any needed database updates.
     54 * One by one, download and enable the new, upgraded version of each third party module to your modules directory (`web/sites/default/modules`). After enabling each module, return to the update.php script to run any needed database updates.
    6355
    6456When you are done - report your results! Let us know how it goes. Edit this page to add new lessons learned.