Help:Upgrading MediaWiki

From GRWiktionaryHelp

Install as with a fresh copy of MediaWiki, but give it the database information for the existing database. It will try to upgrade the database schema as necessary automatically.

Upgrades are not always foolproof; be sure to back everything up! You will have to make any LocalSettings.php customizations on the newly generated LocalSettings.php.

Be sure to backup all your files before you start.

Contents 1 Upgrading to the latest version (1.4.7) 2 Upgrading from 1.3.x betas 3 Upgrading from 1.2.x 4 Upgrading from 1.1.x or earlier 5 Upgrading from UseModWiki or old "phase 2" Wikipedia code 5.1 Examples

Upgrading to the latest version (1.4.7)

The best place to look for upgrade instructions is in the file "UPGRADE" that comes along with the archive file. It had detailed instructions on how to perform the upgrade.

Versions since 1.4.0 have the ability to run an in-place upgrade script from the command line, keeping your existing LocalSettings.php. This requires that you create an AdminSettings.php giving an appropriate database user and password with privileges to modify the database structure. (A Sample AdminSettings.php is included in the distribution)

Upgrading from 1.3.x betas

Should generally go smoothly.

Note that the 1.3 beta releases included a potential vulnerability if PHP is configured with register_globals on and the includes directory is served to the web. For general safety, turn register_globals off if you don't really need it for another package.

If your hosting provider turns it on and you can't turn it off yourself, send them a kind note explaining that it can expose their servers and their customers to attacks.

Two examples: m:Upgrade_from_1.3_to_1.4

Upgrading from 1.2.x

If you've been using the MediaWiki: namespace for custom page templates, note that things are a little different. The Template: namespace has been added which is more powerful -- templates can include parameters for instance.

Any MediaWiki: entries that are not used by the software will be automatically moved to Template: entries at upgrade time. Be sure to go through and check that everything is working properly.

Also, be sure to pick the correct character encoding -- some languages were only available in Latin-1 on 1.2.x and are now available for Unicode as well. If you want to upgrade an existing wiki from Latin-1 to Unicode you'll have to dump the database to SQL, run it through iconv or another conversion tool, and restore it. Sorry.

example: m:upgrade from 1.2 to 1.3

Upgrading from 1.1.x or earlier

This is less thoroughly tested, but should work.

You need to specify the *admin* database username and password to the installer in order for it to successfully upgrade the database structure. You may wish to manually change the GRANTs later.

If you have a very old database, you may need to manually run some of the update scripts from maintenance/archives to get up to circa November 2003 levels before the automatic updater works.

Upgrading from UseModWiki or old "phase 2" Wikipedia code

There is an unmaintained UseModWiki to MediaWiki conversion script at maintenance/importUseModWiki.php; it may require tweaking and customization to work for you.

Install a new MediaWiki first, then use the conversion script which will output SQL statements; direct these to a file and then run that into your database.

You will have to rebuild the links tables etc after importing.

Examples

m:upgrade from 1.2 to 1.3