MediaWiki/Upgrading

From DreamHost
Jump to: navigation, search

< MediaWiki

  1. 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).
  2. (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).
  3. (If necessary) Upgrade MediaWiki using the Goodies > One-Click Installs (How to Upgrade a One-Click Install).
  4. 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 cd to your MediaWiki directory
    • In all cases, you will need to update the database tables. Type the following commands into your shell:
      • cd maintenance/
      • /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

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!