Changes between Version 10 and Version 11 of faq/drupal/upgrade


Ignore:
Timestamp:
Apr 30, 2008, 11:07:21 AM (14 years ago)
Author:
Jamie McClelland
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • faq/drupal/upgrade

    v10 v11  
    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 ''Please note:'' If you primary host is `viewsic.mayfirst.org`, please add a support ticket. Upgrading Drupal on viewsic.mayfirst.org is a different process than upgrading on our other servers. In addition, these directions are for upgrading from 4.7 to 5.2. If you are running Drupal 4.6, you will first need to upgrade to 4.7 before you can follow these directions.
     17''Please note:'' If you primary host is `viewsic.mayfirst.org`, please add a support ticket. Upgrading Drupal on viewsic.mayfirst.org is a different process than upgrading on our other servers. In addition, these directions are for upgrading from 4.7 to 5, however, they also apply if you are upgrading from 4.6. Please remember - you must upgrade incrementally. In other words, you can't go directly from 4.6 to 5. You must first upgrade from 4.6 to 4.7, and then upgrade from 4.7 to 5.
    1818
    1919 * 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.
    2020
    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 directory. For each module installed, search the http://drupal.org web site to find the Drupal 5 version of those modules. If you can't find a Drupal 5 version of a module you are using you will not be able to use it! For each module, download the Drupal 5 version to your 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 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.
    2222
    2323 * 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, after the upgrade try switching to your custom theme.
     
    3636 * Go to your admin/settings page and check the box to indicate that your site is down for maintenance.
    3737
    38  * 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. Uncheck each third party module that is checked.
     38 * 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.
    3939
    4040 * Secure shell (ssh) into your site. Move your old modules out of the way. From your web/sites/default directory, execute:
     
    4545}}}
    4646
    47  * Run the change-drupal-symlinks-to-5 script. You will need to pass one argument to the script, which is the path to your web directory:
     47 * Run the mf-change-drupal-symlinks script. First change into your web directory, then run the command passing the version of Drupal you want to change to (in this example, it is Drupal 5):
    4848
    4949{{{
    50 change-drupal-symlinks-to-5 /home/members/<your-group-name>/sites/<your-domain-name>/web
     50cd home/members/<your-group-name>/sites/<your-domain-name>/web
     51mf-change-drupal-symlinks 5
    5152}}}
    5253