Same filename and directory in other branches
  1. 4.7.x UPGRADE.txt
  2. 6.x UPGRADE.txt
  3. 7.x UPGRADE.txt
UPGRADING
---------

1.  Backup your database and Drupal directory - especially your
    "sites" directory which contains your configuration file and
    added modules and themes, any contributed modules in your
    "modules" directory, and your "files" directory which contains
    uploaded files.

    Note: for a single site setup the configuration file is the
    "settings.php" file located at sites/default/settings.php.
    For multisite configuration the configuration file is located
    in a structure like the following:

      sites/default/settings.php
      sites/example.com/settings.php
      sites/sub.example.com/settings.php
      sites/sub.example.com.path/settings.php

    More information on multisite configuration is located in
    the INSTALL.txt file.

2.  Log on as the user with user ID 1.  User ID 1 is the first
    account created and the main administrator account.  User
    ID 1 needs to be logged in so that you can access update.php
    (step 9) which can only be run by user ID 1.  Do not close
    your browser until step 10 is complete.

3.  Place the site in "Off-line" mode, to mask any errors from
    site visitors.

4.  Disable contributed modules and switch to a core theme
    (Bluemarine or Garland).

5.  Remove all of the old files and directories from the Drupal
    installation directory.

6.  Unpack the new Drupal files and directories into the Drupal
    installation directory.

7.  Copy the backed up "files" and "sites" directories to the
    Drupal installation directory. If the original .htaccess or
    robots.txt files have been modified, copy the backed up
    versions of these files to the installation directory as
    well.

8.  Verify the new configuration file to make sure it has the
    latest and correct information.

9.  Re-install contributed modules.

    Note: make sure the version of a module matches your
    version of Drupal.  Modules from previous versions may
    not be compatible with the current version.  Check
    http://drupal.org/project/Modules for the version of a
    module to match your version of Drupal.

10. Run update.php by visiting http://www.example.com/update.php
    (replace www.example.com with your drupal installation's
    domain name and path).  This step will update the database to
    the new Drupal installation.

    Note: if you are unable to access update.php do the following:

      - Open update.php with a text editor.

      - There is a line near top of update.php that says
        $access_check = TRUE;. Change it to $access_check = FALSE;.

      - As soon as the script is done, you must change the update.php
        script back to its original form to $access_check = TRUE;.

11. Finally, return site to "Online" mode so your visitors may resume
    browsing.

For more information on upgrading visit the Drupal handbook at
http://drupal.org/upgrade

File

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