| Index: branches/wikidata/phase3/UPGRADE |
| — | — | @@ -1,3 +1,30 @@ |
| | 2 | +== IMPORTANT: Upgrading custom namespaces to the new namespace system == |
| | 3 | + |
| | 4 | +If you have custom namespaces defined in the $wgExtraNamespaces array you'll |
| | 5 | +have to take special precautions when upgrading. You can't run the installer on |
| | 6 | +your existing database and expect your old namespace settings (or any settings |
| | 7 | +for that matter) to be carried over to your new installation. Rather you'll |
| | 8 | +have to: |
| | 9 | + |
| | 10 | +1. Upgrade your MediaWiki source tree |
| | 11 | +2. Place your old LocalSettings.php and AdminSettings.php in the root directory |
| | 12 | +3. Run php maintenance/update.php |
| | 13 | + |
| | 14 | +This should create the `namespace` and `namespace_names` tables and populate |
| | 15 | +them with values based on your site language, any custom namespace settings you |
| | 16 | +may have, the site name etc. |
| | 17 | + |
| | 18 | +---- |
| | 19 | + |
| | 20 | +Note: If you really want to make the installar create a fresh LocalSettings.php |
| | 21 | +file even though you have custom namespaces defined you could run the |
| | 22 | +installer and after the installation has finished copy your old |
| | 23 | +$wgExtraNamespaces array from your old LocalSettings.php to your new |
| | 24 | +LocalSettings.php, DROP the namespace` and `namespace_names` tables and run |
| | 25 | +php maintenance/update.php. Which should populate the two tables properly, |
| | 26 | +This is not considered a supported upgrade path however so DO THIS AT YOUR OWN |
| | 27 | +RISK. |
| | 28 | + |
| 2 | 29 | == The basic theory == |
| 3 | 30 | |
| 4 | 31 | Generally, within a stable release series (e.g. 1.4.0, 1.4.1, etc) there |