Changes between Version 21 and Version 22 of faq/drupal/upgrade


Ignore:
Timestamp:
Nov 10, 2010, 11:25:43 AM (9 years ago)
Author:
Jamie McClelland
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • faq/drupal/upgrade

    v21 v22  
    55
    66 update::
    7   changing minor versions. Updates represent small changes, usually to fix bugs and security holes. In the Drupal 4 branch, examples of minor version changes are:  4.7.4 to 4.7.5. In the Drupal 5 branch, examples of minor version changes are 5.1 to 5.2.
     7  changing minor versions. Updates represent small changes, usually to fix bugs and security holes. In the Drupal 4 branch, examples of minor version changes are:  4.7.4 to 4.7.5. In the Drupal 5, 6, and 7 branches, examples of minor version changes are 5.1 to 5.2 or 6.5 to 6.6.
    88 upgrade::
    9   an upgrade means changing between major Drupal versions. That means going from 4.6 to 4.7. Or from 4.7 to 5. Or from 5 to 6.
     9  an upgrade means changing between major Drupal versions. That means going from 4.6 to 4.7. Or from 4.7 to 5. Or from 5 to 6. Or from 6 to 7.
    1010
    1111Why doesn't May First/People Link do major upgrades? We would love to! However, it is a complicated process that is different for each site. In other words, we cannot automate the process, like we can for minor updates. If we upgraded everyone's Drupal web site we would have no time to do anything else!
     
    1515If you would like to upgrade your site, here are directions for how to do that. If you are not comfortable doing this, and you are able to hire a developer to help, please [/newticket?type=Project/Need+to+hire+someone post a ticket of the type "Project/Need to hire someone"] and we will try to match you with a techie.
    1616
    17 
    18 In 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.
     17In addition, these directions are for upgrading from 5 to 6, however, they also apply if you are upgrading from 6 to 7 (or, roughly, if you are going from 4.7 to 5). Please remember - you must upgrade incrementally. In other words, you can't go directly from 4.7 to 7. 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.
    1918
    2019 * 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.
    2120
    22  * Plan the upgrade. You should be prepared to spend several hours upgrading your site. If all goes smoothly you won't need that time, however, it's better to be prepared. Before beginning, review all of the third party modules that you have installed. You can review these modules by looking in your web/sites/default/modules directory. For each module installed, search the http://drupal.org web site to find the Drupal version of the module corresponding to the Drupal version you are upgrading to. If you can't find an appropriate version (this happens often) you will not be able to use it! For each module, download the new version to your local computer.
     21 * Plan the upgrade. You should be prepared to spend several hours upgrading your site. If all goes smoothly you won't need that time, however, it's better to be prepared. Before beginning, review all of the third party modules that you have installed. You can review these modules by looking in your web/sites/default/modules or web/sites/all/modules directory. For each module installed, search the http://drupal.org web site to find the Drupal version of the module corresponding to the Drupal version you are upgrading to. If you can't find an appropriate version (this happens often) you will not be able to use it! For each module, download the new version to your local computer.
    2322
    2423 * 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.
    2524
    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:
     25 * Upgrade all your third party modules to the most recent version. If you are running Drupal 5 or later, 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:
    2726{{{
    2827drush pm-update
    2928}}}
     29 If you are upgrading from a version prior to 5, well, there's nothing you can do but hope for the best!
     30
    3031 * Test to make sure your site is still functioning properly before you continue.
    3132
     
    4243 * Disable all third party modules. Go to the modules admin section of your web site. Compare the enabled modules with your list of third party modules. You can find a list of your third party modules by looking in your web/sites/default/modules directory. Uncheck each third party module that is checked.
    4344
    44  * 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.
     45 * Using [wiki:sftp secure FTP] or [wiki:secure_shell ssh], rename the modules directory your sites/default/modules directory to modules.d5 (or d6, etc.). Create a new, empty modules directory.
    4546
    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. Note: if you don't see an entry under Web Apps, it means your existing installation is prior to Drupal 5 or was not originally installed as a part of the May First/People Link Drupal system. Please [/newticket open a ticket] for assistance!
     47 * 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. Note: if you don't see an entry under Web Apps, it means your existing installation is prior to Drupal 5 or was not originally installed as a part of the May First/People Link Drupal system.
     48 
     49In this case - you will need to remove all the files in your web directory ''except'' the sites directory and, if you have them, files or images directories. Be sure to remove the .htaccess file as well. Once you have removed these files and directories, then use the Members Control panel to install Drupal. If you previously were running a version of Drupal that is installable by the control panel, install that version to ensure everything is still working smoothly. Then, edit your installation to change from your current version to the next available version. If you are running a version older than version 5, then install version 5.
    4750
    4851 * 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