| Index: trunk/phase3/UPGRADE |
| — | — | @@ -29,7 +29,7 @@ |
| 30 | 30 | not fail, leaving the database in an inconsistent state. |
| 31 | 31 | |
| 32 | 32 | http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki provides an overview of |
| 33 | | -the upgrade process. You should also refer to the documentation for your |
| | 33 | +the backup process. You should also refer to the documentation for your |
| 34 | 34 | database management system for information on backing up a database, and to |
| 35 | 35 | your operating system documentation for information on making copies of files. |
| 36 | 36 | |
| — | — | @@ -51,22 +51,12 @@ |
| 52 | 52 | |
| 53 | 53 | === Perform the database upgrade === |
| 54 | 54 | |
| 55 | | -You will need to have $wgDBadminuser and $wgDBadminpassword set in your |
| 56 | | -LocalSettings.php, see there for more info. |
| 57 | | - |
| 58 | 55 | ==== From the web ==== |
| 59 | 56 | |
| 60 | | -You will need to set $wgUpgradeKey in your LocalSettings.php in order to use |
| 61 | | -the updater. |
| | 57 | +If you browse to the web-based installation script (usually at |
| | 58 | +/mw-config/index.php) from your wiki installation you can follow the script and |
| | 59 | +upgrade your database in place. |
| 62 | 60 | |
| 63 | | -If you browse to the web-based installation script (usually at /config/index.php) |
| 64 | | -from your wiki installation you can follow the script and upgrade your database |
| 65 | | -in place. |
| 66 | | - |
| 67 | | -You may change some settings during the install, but be very careful! |
| 68 | | -Changing the encoding in particular will generally leave you with a |
| 69 | | -lot of corrupt pages, particularly if your wiki is not in English. |
| 70 | | - |
| 71 | 61 | ==== From the command line ==== |
| 72 | 62 | |
| 73 | 63 | From the command line, browse to the "maintenance" directory and run the |
| — | — | @@ -74,14 +64,6 @@ |
| 75 | 65 | tables, update existing tables, and move data around as needed. In most cases, |
| 76 | 66 | this is successful and nothing further needs to be done. |
| 77 | 67 | |
| 78 | | -If you have a Chinese or Japanese wiki ($wgLanguageCode is set to one |
| 79 | | -of "zh", "ja", or "yue") and you are using MySQL fulltext search, you |
| 80 | | -will probably want to update the search index. |
| 81 | | - |
| 82 | | -In the "maintenance" directory, run the updateDoubleWidthSearch.php |
| 83 | | -script. This will update the searchindex table for those pages that |
| 84 | | -contain double-byte latin characters. |
| 85 | | - |
| 86 | 68 | === Check configuration settings === |
| 87 | 69 | |
| 88 | 70 | The names of configuration variables, and their default values and purposes, |
| — | — | @@ -92,6 +74,8 @@ |
| 93 | 75 | |
| 94 | 76 | === Check installed extensions === |
| 95 | 77 | |
| | 78 | +Extensions usually need to be upgraded at the same time as the MediaWiki core. |
| | 79 | + |
| 96 | 80 | In MediaWiki 1.14 some extensions are migrated into the core. Please see the |
| 97 | 81 | HISTORY section "Migrated extensions" and disable these extensions in your |
| 98 | 82 | LocalSettings.php |
| — | — | @@ -105,8 +89,18 @@ |
| 106 | 90 | |
| 107 | 91 | You should also test any extensions, and upgrade these if necessary. |
| 108 | 92 | |
| 109 | | -== Upgrading from 1.8 wikis == |
| | 93 | +== Upgrading from 1.16 or earlier == |
| 110 | 94 | |
| | 95 | +If you have a Chinese or Japanese wiki ($wgLanguageCode is set to one |
| | 96 | +of "zh", "ja", or "yue") and you are using MySQL fulltext search, you |
| | 97 | +will probably want to update the search index. |
| | 98 | + |
| | 99 | +In the "maintenance" directory, run the updateDoubleWidthSearch.php |
| | 100 | +script. This will update the searchindex table for those pages that |
| | 101 | +contain double-byte latin characters. |
| | 102 | + |
| | 103 | +== Upgrading from 1.8 or earlier == |
| | 104 | + |
| 111 | 105 | MediaWiki 1.9 and later no longer keep default localized message text |
| 112 | 106 | in the database; 'MediaWiki:'-namespace pages that do not exist in the |
| 113 | 107 | database are simply transparently filled-in on demand. |
| — | — | @@ -121,17 +115,17 @@ |
| 122 | 116 | |
| 123 | 117 | See RELEASE-NOTES for more details about new and changed options. |
| 124 | 118 | |
| 125 | | -== Upgrading from 1.7 wikis == |
| | 119 | +== Upgrading from 1.7 or earlier == |
| 126 | 120 | |
| 127 | 121 | $wgDefaultUserOptions now contains all the defaults, not only overrides. |
| 128 | 122 | If you're setting this as a complete array(), you may need to change it |
| 129 | 123 | to set only specific items as recommended in DefaultSettings.php. |
| 130 | 124 | |
| 131 | | -== Upgrading from 1.6 wikis == |
| | 125 | +== Upgrading from 1.6 or earlier == |
| 132 | 126 | |
| 133 | 127 | $wgLocalTZoffset was in hours, it is now using minutes. |
| 134 | 128 | |
| 135 | | -== Upgrading from pre-1.5 wikis == |
| | 129 | +== Upgrading from 1.5 or earlier == |
| 136 | 130 | |
| 137 | 131 | Major changes have been made to the schema from 1.4.x. The updater |
| 138 | 132 | has not been fully tested for all conditions, and might well break. |
| — | — | @@ -187,33 +181,8 @@ |
| 188 | 182 | should be replaced with: |
| 189 | 183 | $wgMainCacheType = CACHE_MEMCACHED; |
| 190 | 184 | |
| 191 | | -== Backups! == |
| | 185 | +== Upgrading from 1.4.2 or earlier == |
| 192 | 186 | |
| 193 | | -To upgrade an existing MediaWiki installation, first BACK UP YOUR WIKI! |
| 194 | | -If something goes wrong, you want to be able to start again. |
| 195 | | - |
| 196 | | -Your image files, configuration, etc can simply be copied or archived as |
| 197 | | -you would any other files. (Make sure that the contents of your |
| 198 | | -LocalSettings.php are not accidentally made public, as this contains |
| 199 | | -a database password.) |
| 200 | | - |
| 201 | | -To back up the database, use the tools provided by your service provider |
| 202 | | -(if applicable) or the standard mysqldump or pg_dump programs. |
| 203 | | - |
| 204 | | -For general help on mysqldump: |
| 205 | | -http://dev.mysql.com/doc/mysql/en/mysqldump.html |
| 206 | | - |
| 207 | | -WARNING: If using MySQL 4.1.x, mysqldump's charset conversion may in |
| 208 | | -some cases damage data in your wiki. If necessary, set the charset |
| 209 | | -option to 'latin1' to avoid the conversion. |
| 210 | | - |
| 211 | | -For general help on pg_dump: |
| 212 | | -http://www.postgresql.org/docs/current/static/app-pgdump.html |
| 213 | | - |
| 214 | | -== Caveats == |
| 215 | | - |
| 216 | | -=== Upgrading from 1.4.2 or earlier === |
| 217 | | - |
| 218 | 187 | 1.4.3 has added new fields to the sitestats table. These fields are |
| 219 | 188 | optional and help to speed Special:Statistics on large sites. If you |
| 220 | 189 | choose not to run the database upgrades, everything will continue to |
| — | — | @@ -224,7 +193,7 @@ |
| 225 | 194 | maintenance/archives/patch-ss_total_articles.sql |
| 226 | 195 | |
| 227 | 196 | |
| 228 | | -=== Upgrading from 1.4rc1 or earlier betas === |
| | 197 | +== Upgrading from 1.4rc1 or earlier betas == |
| 229 | 198 | |
| 230 | 199 | The logging table has been altered from 1.4beta4 to 1.4beta5 |
| 231 | 200 | and again in 1.4.0 final. Copy in the new files and use the web |
| — | — | @@ -237,7 +206,7 @@ |
| 238 | 207 | maintenance/archives/patch-logging-title.sql |
| 239 | 208 | |
| 240 | 209 | |
| 241 | | -=== Upgrading from 1.3.x === |
| | 210 | +== Upgrading from 1.3 or earlier == |
| 242 | 211 | |
| 243 | 212 | This should generally go smoothly. |
| 244 | 213 | |
| — | — | @@ -280,7 +249,7 @@ |
| 281 | 250 | customers to attacks. |
| 282 | 251 | |
| 283 | 252 | |
| 284 | | -=== Upgrading from 1.2.x === |
| | 253 | +== Upgrading from 1.2 or earlier == |
| 285 | 254 | |
| 286 | 255 | If you've been using the MediaWiki: namespace for custom page templates, |
| 287 | 256 | note that things are a little different. The Template: namespace has been |
| — | — | @@ -300,7 +269,7 @@ |
| 301 | 270 | and restore it. Sorry. |
| 302 | 271 | |
| 303 | 272 | |
| 304 | | -=== Upgrading from 1.1.x or earlier === |
| | 273 | +== Upgrading from 1.1 or earlier == |
| 305 | 274 | |
| 306 | 275 | This is less thoroughly tested, but should work. |
| 307 | 276 | |
| — | — | @@ -314,7 +283,7 @@ |
| 315 | 284 | with remaining updates. |
| 316 | 285 | |
| 317 | 286 | |
| 318 | | -=== Upgrading from UseModWiki or old "phase 2" Wikipedia code === |
| | 287 | +== Upgrading from UseModWiki or old "phase 2" Wikipedia code == |
| 319 | 288 | |
| 320 | 289 | There is a semi-maintained UseModWiki to MediaWiki conversion script at |
| 321 | 290 | maintenance/importUseModWiki.php; it may require tweaking and customization |
| — | — | @@ -325,3 +294,5 @@ |
| 326 | 295 | database. |
| 327 | 296 | |
| 328 | 297 | You will have to rebuild the links tables etc after importing. |
| | 298 | + |
| | 299 | + |