- Back up your wiki database.
- Upgrading changes the MySQL database, so this is for safety.
- The MediaWiki code directory (on your shell account) will be backed up as part of upgrading. If you’re extra-paranoid, back it up separately beforehand, but if you have no customizations this shouldn't be necessary (it just points at your database).
- (If necessary) Upgrade PHP (Updating PHP: Overview and FAQs).
- panel.dreamhost.com → Manage Domains → Web Hosting (column) → Edit (Easiest is “Automatically upgrade PHP”)
- Current versions of MediaWiki require PHP 5.3. If you've been running PHP 4 on your domain or PHP 5.2 (yikes!), upgrade to at least PHP 5.3 (as of 2015, PHP 5.5 is recommended and default).
- (If necessary) Upgrade MediaWiki using the Goodies > One-Click Installs (How to Upgrade a One-Click Install).
- Update your database tables by running one update script.
- Until you do so, you will get the following error: “A database query error has occurred. This may indicate a bug in the software.”
- Login through the shell and
cdto your MediaWiki directory
- In all cases, you will need to update the database tables. Type the following commands into your shell:
/usr/local/php54/bin/php update.php --quick
- "Deleting old default messages" may take 5-10 minutes, depending on the size of your database
…and you’re in business.
In case of problems, see mw:Manual:Upgrading.
Older versions of this page have information on upgrading to non-current versions of MediaWiki.
As of MediaWiki 1.16, the AdminSettings.php file (and its upgrade) are no longer required.
MediaWiki 1.19 may still use PHP 5.2, however, it is not recommended!