Prepare for alpha release.
[project/cck.git] / UPGRADE.txt
CommitLineData
c7c1c5d9
YC
1// $Id$
2
a0e4ca62
KS
3================================================================
4UPDATING FROM VERSION 4.7 to 6.x
5================================================================
6
7THERE IS NO DIRECT UPGRADE PATH FROM 4.7 TO 6.x!! FIRST UPGRADE
8YOUR DATABASE FROM 4.7 TO THE LATEST 5.x VERSION, THEN UPGRADE
9TO 6.x.
10
48c9a6da 11ALWAYS BACKUP YOUR DATABASE BEFORE UPGRADING!
a0e4ca62
KS
12
131) While 4.7 is still installed, upload the latest 4.7 version of
48c9a6da
YC
14 all the CCK files, go to update.php, and run all possible
15 updates for the Content module and all field modules.
a0e4ca62
KS
16
172) Install Drupal version 5. Once it is running, upload and install
48c9a6da
YC
18 the latest 5.x versions of all CCK modules, go to update.php and
19 run all possible updates.
a0e4ca62 20
b3097280 21Jump to the instructions for updating from version 5.x to 6.x.
a0e4ca62
KS
22
23================================================================
cfff5104 24UPDATING FROM VERSION 5.x to 6.x
a0e4ca62
KS
25================================================================
26
d1eac231 27YOU MUST RUN ALL POSSIBLE UPDATES TO YOUR DATABASE IN 5.x USING
a0e4ca62
KS
28THE LATEST 5.x CODE, BEFORE UPGRADING FROM 5.x to 6.x.
29
48c9a6da 30ALWAYS BACKUP YOUR DATABASE BEFORE UPGRADING!
a0e4ca62 31
d1eac231 321) Before upgrading to 6.x, upload the latest 5.x versions of all
48c9a6da 33 CCK modules, go to update.php and run all possible updates.
a0e4ca62 34
b3097280
KS
352) Disable all CCK modules and remove them from the modules folder
36 before upgrading.
37
383) Install Drupal version 6. Leave all contributed modules out of
39 the modules folder until core modules are up and running.
d9c1e408
KS
40 Set your administration theme to a core theme like Garland until
41 everything has been updated to help ensure you don't encounter
42 theme-related problems accessing the administration area.
b3097280
KS
43
444) Once core is running, upload and install the latest 6.x versions
45 of ONLY CCK CORE FILES (the ones in the tarball on the CCK
46 project page). Enable them, then go to update.php and run all
47 possible updates. DO NOT add any other CCK modules to the
48 modules folder until the core CCK files are updated and working
49 correctly.
50
d9c1e408
KS
515) After updating CCK core modules, you may get messages saying that
52 some updates failed and that you need to run update.php again.
53 If you get messages like that, keep re-running update.php until
54 you get no more messages.
55
566) Once the core CCK modules are updated and working correctly,
b3097280
KS
57 add other CCK modules to the modules folder, enable them,
58 and run update.php. For best results, do this one module at a
59 time so you can tell immediately if any of them create problems
60 without letting those problems interfere with other updates.
a0e4ca62 61
d9c1e408 62
a0e4ca62
KS
63Your database should now be ready to run in CCK version 6.x
64
65================================================================
66
b3097280
KS
67The 4.7 to 5.x steps are necessary because of significant changes
68in the database structure between the 4.7 and 6.x versions. These changes
d1eac231 69make it extremely difficult to create an automatic upgrade path that
a0e4ca62 70will work reliably in every possible situation.
b3097280
KS
71
72The extra steps in the 5.x to 6.x upgrade are because all modules
73in the modules folder are automatically updated in Drupal 6, even if they
74are not enabled. That means that modules that rely on core CCK may try
75to run their updates even if core CCK is not enabled, and contributed
76CCK modules that have broken updates will have their broken updates
77run even if they are not enabled.
78
d9c1e408
KS
79A number of updates are dependent on other updates and won't work
80until previous updates are finished or specific modules are enabled,
81so you may get messages that other modules need to be enabled or that
82update.php needs to be re-run, and you need to follow those instructions
83until all the updates complete.
84
b3097280
KS
85Taking extra time during the upgrade by leaving modules out of the
86modules folder altogether until you are ready to enable and update them
87should reduce or eliminate update problems.