summaryrefslogtreecommitdiff
path: root/UPGRADE.txt
blob: c7415e2c143bfc73863cb4873c403a61691d1782 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
// $Id$

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. Disable contributed modules and switch to a core theme
   (Bluemarine or Garland).

3. 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 8) which can only be run by user ID 1.  Do not close
   your browser until step 9 is complete.

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

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

6. 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.

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

8. 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.

9. 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;.

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