UPGRADE.txt

   1 // $Id: UPGRADE.txt,v 1.8 2007/01/09 09:16:10 dries Exp $
   2
   3 UPGRADING
   4 ---------
   5
   6 1.  Backup your database and Drupal directory - especially your
   7     "sites" directory which contains your configuration file and
   8     added modules and themes, any contributed modules in your
   9     "modules" directory, and your "files" directory which contains
  10     uploaded files.
  11
  12     Note: for a single site setup the configuration file is the
  13     "settings.php" file located at sites/default/settings.php.
  14     For multisite configuration the configuration file is located
  15     in a structure like the following:
  16
  17       sites/default/settings.php
  18       sites/example.com/settings.php
  19       sites/sub.example.com/settings.php
  20       sites/sub.example.com.path/settings.php
  21
  22     More information on multisite configuration is located in
  23     the INSTALL.txt file.
  24
  25 2.  Log on as the user with user ID 1.  User ID 1 is the first
  26     account created and the main administrator account.  User
  27     ID 1 needs to be logged in so that you can access update.php
  28     (step 9) which can only be run by user ID 1.  Do not close
  29     your browser until step 10 is complete.
  30
  31 3.  Place the site in "Off-line" mode, to mask any errors from
  32     site visitors.
  33
  34 4.  Disable contributed modules and switch to a core theme
  35     (Bluemarine or Garland).
  36
  37 5.  Remove all of the old files and directories from the Drupal
  38     installation directory.
  39
  40 6.  Unpack the new Drupal files and directories into the Drupal
  41     installation directory.
  42
  43 7.  Copy the backed up "files" and "sites" directories to the
  44     Drupal installation directory. If the original .htaccess or
  45     robots.txt files have been modified, copy the backed up
  46     versions of these files to the installation directory as
  47     well.
  48
  49 8.  Verify the new configuration file to make sure it has the
  50     latest and correct information.
  51
  52 9.  Re-install contributed modules.
  53
  54     Note: make sure the version of a module matches your
  55     version of Drupal.  Modules from previous versions may
  56     not be compatible with the current version.  Check
  57     http://drupal.org/project/Modules for the version of a
  58     module to match your version of Drupal.
  59
  60 10. Run update.php by visiting http://www.example.com/update.php
  61     (replace www.example.com with your drupal installation's
  62     domain name and path).  This step will update the database to
  63     the new Drupal installation.
  64
  65     Note: if you are unable to access update.php do the following:
  66
  67       - Open update.php with a text editor.
  68
  69       - There is a line near top of update.php that says
  70         $access_check = TRUE;. Change it to $access_check = FALSE;.
  71
  72       - As soon as the script is done, you must change the update.php
  73         script back to its original form to $access_check = TRUE;.
  74
  75 11. Finally, return site to "Online" mode so your visitors may resume
  76     browsing.
  77
  78 For more information on upgrading visit the Drupal handbook at
  79 http://drupal.org/upgrade