[ Index ]

PHP Cross Reference of Documentation Drupal

title

Body

[close]

/ -> UPGRADE.txt (source)

   1  INTRODUCTION
   2  ------------
   3  This document describes how to:
   4  
   5    * Update your Drupal site from one minor 7.x version to another minor 7.x
   6      version; for example, from 7.8 to 7.9, or from 7.6 to 7.10.
   7  
   8    * Upgrade your Drupal site's major version from 6.x to 7.x.
   9  
  10  First steps and definitions:
  11  
  12    * If you are upgrading to Drupal version x.y, then x is known as the major
  13      version number, and y is known as the minor version number. The download
  14      file will be named drupal-x.y.tar.gz (or drupal-x.y.zip).
  15  
  16    * All directories mentioned in this document are relative to the directory of
  17      your Drupal installation.
  18  
  19    * Make a full backup of all files, directories, and your database(s) before
  20      starting, and save it outside your Drupal installation directory.
  21      Instructions may be found at http://drupal.org/upgrade/backing-up-the-db
  22  
  23    * It is wise to try an update or upgrade on a test copy of your site before
  24      applying it to your live site. Even minor updates can cause your site's
  25      behavior to change.
  26  
  27    * Each new release of Drupal has release notes, which explain the changes made
  28      since the previous version and any special instructions needed to update or
  29      upgrade to the new version. You can find a link to the release notes for the
  30      version you are upgrading or updating to on the Drupal project page
  31      (http://drupal.org/project/drupal).
  32  
  33  UPGRADE PROBLEMS
  34  ----------------
  35  If you encounter errors during this process,
  36  
  37    * Note any error messages you see.
  38  
  39    * Restore your site to its previous state, using the file and database backups
  40      you created before you started the upgrade process. Do not attempt to do
  41      further upgrades on a site that had update problems.
  42  
  43    * Consult one of the support options listed on http://drupal.org/support
  44  
  45  More in-depth information on upgrading can be found at http://drupal.org/upgrade
  46  
  47  MINOR VERSION UPDATES
  48  ---------------------
  49  To update from one minor 7.x version of Drupal to any later 7.x version, after
  50  following the instructions in the INTRODUCTION section at the top of this file:
  51  
  52  1. Log in as a user with the permission "Administer software updates".
  53  
  54  2. Go to Administration > Configuration > Development > Maintenance mode.
  55     Enable the "Put site into maintenance mode" checkbox and save the
  56     configuration.
  57  
  58  3. Remove all old core files and directories, except for the 'sites' directory
  59     and any custom files you added elsewhere.
  60  
  61     If you made modifications to files like .htaccess or robots.txt, you will
  62     need to re-apply them from your backup, after the new files are in place.
  63  
  64     Sometimes an update includes changes to default.settings.php (this will be
  65     noted in the release notes). If that's the case, follow these steps:
  66  
  67     - Make a backup copy of your settings.php file, with a different file name.
  68  
  69     - Make a copy of the new default.settings.php file, and name the copy
  70       settings.php (overwriting your previous settings.php file).
  71  
  72     - Copy the custom and site-specific entries from the backup you made into the
  73       new settings.php file. You will definitely need the lines giving the
  74       database information, and you will also want to copy in any other
  75       customizations you have added.
  76  
  77  4. Download the latest Drupal 7.x release from http://drupal.org to a
  78     directory outside of your web root. Extract the archive and copy the files
  79     into your Drupal directory.
  80  
  81     On a typical Unix/Linux command line, use the following commands to download
  82     and extract:
  83  
  84       wget http://drupal.org/files/projects/drupal-x.y.tar.gz
  85       tar -zxvf drupal-x.y.tar.gz
  86  
  87     This creates a new directory drupal-x.y/ containing all Drupal files and
  88     directories. Copy the files into your Drupal installation directory:
  89  
  90       cp -R drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation
  91  
  92     If you do not have command line access to your server, download the archive
  93     from http://drupal.org using your web browser, extract it, and then use an
  94     FTP client to upload the files to your web root.
  95  
  96  5. Re-apply any modifications to files such as .htaccess or robots.txt.
  97  
  98  6. Run update.php by visiting http://www.example.com/update.php (replace
  99     www.example.com with your domain name). This will update the core database
 100     tables.
 101  
 102     If you are unable to access update.php do the following:
 103  
 104     - Open settings.php with a text editor.
 105  
 106     - Find the line that says:
 107       $update_free_access = FALSE;
 108  
 109     - Change it into:
 110       $update_free_access = TRUE;
 111  
 112     - Once the upgrade is done, $update_free_access must be reverted to FALSE.
 113  
 114  7. Go to Administration > Reports > Status report. Verify that everything is
 115     working as expected.
 116  
 117  8. Ensure that $update_free_access is FALSE in settings.php.
 118  
 119  9. Go to Administration > Configuration > Development > Maintenance mode.
 120     Disable the "Put site into maintenance mode" checkbox and save the
 121     configuration.
 122  
 123  MAJOR VERSION UPGRADE
 124  ---------------------
 125  To upgrade from a previous major version of Drupal to Drupal 7.x, after
 126  following the instructions in the INTRODUCTION section at the top of this file:
 127  
 128  1. Check on the Drupal 7 status of your contributed and custom modules and
 129     themes. See http://drupal.org/node/948216 for information on upgrading
 130     contributed modules and themes. See http://drupal.org/node/895314 for a list
 131     of modules that have been moved into core for Drupal 7, and instructions on
 132     how to update them. See http://drupal.org/update/modules for information on
 133     how to update your custom modules, and http://drupal.org/update/theme for
 134     custom themes.
 135  
 136     You may decide at this point that you cannot upgrade your site, because
 137     needed modules or themes are not ready for Drupal 7.
 138  
 139  2. Update to the latest available version of Drupal 6.x (if your current version
 140     is Drupal 5.x, you have to upgrade to 6.x first). If you need to update,
 141     download Drupal 6.x and follow the instructions in its UPGRADE.txt. This
 142     document only applies for upgrades from 6.x to 7.x.
 143  
 144  3. In addition to updating to the latest available version of Drupal 6.x core,
 145     you must also upgrade all of your contributed modules for Drupal to their
 146     latest Drupal 6.x versions.
 147  
 148  4. Log in as user ID 1 (the site maintenance user).
 149  
 150  5. Go to Administer > Site configuration > Site maintenance. Select
 151     "Off-line" and save the configuration.
 152  
 153  6. Go to Administer > Site building > Themes. Enable "Garland" and select it as
 154     the default theme.
 155  
 156  7. Go to Administer > Site building > Modules. Disable all modules that are not
 157     listed under "Core - required" or "Core - optional". It is possible that some
 158     modules cannot be disabled, because others depend on them. Repeat this step
 159     until all non-core modules are disabled.
 160  
 161     If you know that you will not re-enable some modules for Drupal 7.x and you
 162     no longer need their data, then you can uninstall them under the Uninstall
 163     tab after disabling them.
 164  
 165  8. On the command line or in your FTP client, remove the file
 166  
 167       sites/default/default.settings.php
 168  
 169  9. Remove all old core files and directories, except for the 'sites' directory
 170     and any custom files you added elsewhere.
 171  
 172     If you made modifications to files like .htaccess or robots.txt, you will
 173     need to re-apply them from your backup, after the new files are in place.
 174  
 175  10. If you uninstalled any modules, remove them from the sites/all/modules and
 176     other sites/*/modules directories. Leave other modules in place, even though
 177     they are incompatible with Drupal 7.x.
 178  
 179  11. Download the latest Drupal 7.x release from http://drupal.org to a
 180     directory outside of your web root. Extract the archive and copy the files
 181     into your Drupal directory.
 182  
 183     On a typical Unix/Linux command line, use the following commands to download
 184     and extract:
 185  
 186       wget http://drupal.org/files/projects/drupal-x.y.tar.gz
 187       tar -zxvf drupal-x.y.tar.gz
 188  
 189     This creates a new directory drupal-x.y/ containing all Drupal files and
 190     directories. Copy the files into your Drupal installation directory:
 191  
 192       cp -R drupal-x.y/* drupal-x.y/.htaccess /path/to/your/installation
 193  
 194     If you do not have command line access to your server, download the archive
 195     from http://drupal.org using your web browser, extract it, and then use an
 196     FTP client to upload the files to your web root.
 197  
 198  12. Re-apply any modifications to files such as .htaccess or robots.txt.
 199  
 200  13. Make your settings.php file writeable, so that the update process can
 201     convert it to the format of Drupal 7.x. settings.php is usually located in
 202  
 203       sites/default/settings.php
 204  
 205  14. Run update.php by visiting http://www.example.com/update.php (replace
 206     www.example.com with your domain name). This will update the core database
 207     tables.
 208  
 209     If you are unable to access update.php do the following:
 210  
 211     - Open settings.php with a text editor.
 212  
 213     - Find the line that says:
 214       $update_free_access = FALSE;
 215  
 216     - Change it into:
 217       $update_free_access = TRUE;
 218  
 219     - Once the upgrade is done, $update_free_access must be reverted to FALSE.
 220  
 221  15. Backup your database after the core upgrade has run.
 222  
 223  16. Replace and update your non-core modules and themes, following the
 224     procedures at http://drupal.org/node/948216
 225  
 226  17. Go to Administration > Reports > Status report. Verify that everything is
 227     working as expected.
 228  
 229  18. Ensure that $update_free_access is FALSE in settings.php.
 230  
 231  19. Go to Administration > Configuration > Development > Maintenance mode.
 232     Disable the "Put site into maintenance mode" checkbox and save the
 233     configuration.
 234  
 235  To get started with Drupal 7 administration, visit
 236  http://drupal.org/getting-started/7/admin


Développeurs Drupal & Développement mobile Montréal
Generated: Thu Feb 21 17:10:26 2013 Cross-referenced by PHPXref 0.7.1