8b810330c2
This is for when trying to upgrade from versions older than 1.27 Bug: T259771 Change-Id: If171fafb7c5ebfb6a68d1685bfeb6198abd6bab2
104 lines
4.4 KiB
Text
104 lines
4.4 KiB
Text
This file provides an overview of the MediaWiki upgrade process. For help with
|
||
specific problems, you should check:
|
||
|
||
* the docs at https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents ;
|
||
* the mediawiki-l mailing list archive at
|
||
https://lists.wikimedia.org/pipermail/mediawiki-l/ ; and
|
||
* the bug tracker at https://phabricator.wikimedia.org/
|
||
|
||
… for information and workarounds to common issues.
|
||
|
||
== Overview ==
|
||
|
||
We provide comprehensive documentation on upgrading to the latest version of the
|
||
software at https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Upgrading.
|
||
|
||
Important: Upgrading from releases older than two LTS release is not supported anymore.
|
||
If you want to upgrade from an old version, please upgrade to a more recent LTS version first,
|
||
then to this version.
|
||
|
||
Currently any upgrade from any version older than 1.27 will fail.
|
||
|
||
=== Consult the release notes ===
|
||
|
||
Before doing anything, stop and consult the release notes supplied with the new
|
||
version of the software. These detail bug fixes, new features and functionality,
|
||
and any particular points that may need to be noted during the upgrade process.
|
||
|
||
=== Backup first ===
|
||
|
||
It is imperative that, prior to attempting an upgrade of the database schema,
|
||
you take a complete backup of your wiki database and files and verify it. While
|
||
the upgrade scripts are somewhat robust, there is no guarantee that things will
|
||
not fail, leaving the database in an inconsistent state.
|
||
|
||
https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Backing_up_a_wiki is an
|
||
overview of the backup process. You should also refer to the documentation for
|
||
your database management system for information on backing up a database, and to
|
||
your operating system documentation for information on making copies of files.
|
||
|
||
=== Perform the file upgrade ===
|
||
|
||
Download the files for the new version of the software. These are available as a
|
||
compressed "tar" archive from the Wikimedia Download Service
|
||
(https://releases.wikimedia.org/mediawiki/).
|
||
|
||
You can also obtain the new files directly from our Git source code repository.
|
||
|
||
Replace the existing MediaWiki files with the new. You should preserve the
|
||
LocalSettings.php file and the "extensions" and "images" directories.
|
||
|
||
Depending upon your configuration, you may also need to preserve additional
|
||
directories, including a custom upload directory ($wgUploadDirectory),
|
||
deleted file archives, and any custom skins.
|
||
|
||
=== Perform the database upgrade ===
|
||
|
||
As of 1.21, it is possible to separate schema changes (i.e. adding, dropping, or
|
||
changing tables, fields, or indices) from all other database changes (e.g.
|
||
populating fields). If you need this capability, see "From the command line"
|
||
below.
|
||
|
||
==== From the Web ====
|
||
|
||
If you browse to the Web-based installation script (usually at
|
||
./mw-config/index.php) from your wiki installation you can follow the script and
|
||
upgrade your database in place.
|
||
|
||
==== From the command line ====
|
||
|
||
From the command line, browse to the "maintenance" directory and run the
|
||
update.php script to check and update the schema. This will insert missing
|
||
tables, update existing tables, and move data around as needed. In most cases,
|
||
this is successful and nothing further needs to be done.
|
||
|
||
If you need to separate out the schema changes so they can be run by someone
|
||
with more privileges, then you can use the --schema option to produce a text
|
||
file with the necessary commands. You can use --schema, --noschema,
|
||
$wgAllowSchemaUpdates as well as proper database permissions to enforce this
|
||
separation.
|
||
|
||
=== Check configuration settings ===
|
||
|
||
The names of configuration variables, and their default values and purposes, can
|
||
change between release branches, e.g. $wgDisableUploads in 1.4 is replaced with
|
||
$wgEnableUploads in later versions. When upgrading, consult the release notes to
|
||
check for configuration changes which would alter the expected behavior of
|
||
MediaWiki.
|
||
|
||
=== Check installed extensions ===
|
||
|
||
Extensions usually need to be upgraded at the same time as the MediaWiki core.
|
||
|
||
In MediaWiki 1.14 some extensions were migrated into the core. Please see the
|
||
HISTORY section "Migrated extensions" and disable these extensions in your
|
||
LocalSettings.php
|
||
|
||
=== Test ===
|
||
|
||
It makes sense to test your wiki immediately following any kind of maintenance
|
||
procedure, and especially after upgrading; check that page views and edits work
|
||
normally, that special pages continue to function, etc., and correct any errors
|
||
and quirks which reveal themselves.
|
||
|
||
You should also test any extensions, and upgrade these if necessary.
|