ProleWiki:Maintenance/Updating MediaWiki

From ProleWiki, the proletarian encyclopedia
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This is a page for a step-by-step tutorial on updating the MediaWiki, for future reference.

Step 1: Backup everything

ProleWiki already has a rudimentary and simple backup system, thanks to comrade MxAsh. We have the backup of the all files in another server.

Step 2: Download the tarball

Go to the webroot directory[a] and download the tarball of the new MediaWiki release:

wget https://releases.wikimedia.org/mediawiki/1.40/mediawiki-1.40.0.tar.gz

And extract them:

tar -xvf mediawiki-1.40.0.tar.gz

Step 3: Move folders and files

The following folders and files should be preserved:

  • uploads/[b] (where all uploads are stored)
  • resources/assets/[c]
  • skins/Citizen/
  • languageSelector.php (it's what produces prolewiki.org)

Step 4: Update extensions and databases

Run this code inside the webroot to update a few extensions and save some work:

php composer.phar update

Full list of extensions (some of them bundled with MediaWiki):

AbuseFilter [BUNDLED]
CategoryTree [BUNDLED]
Cite [BUNDLED]
CiteThisPage [BUNDLED]
CodeEditor [BUNDLED]
CodeMirror
ConfirmAccount
ConfirmEdit [BUNDLED]
ContentTranslation
ContributionScores
CreatedPagesList
CSS
Discord
DiscussionTools [BUNDLED]
DismissableSiteNotice
Echo [BUNDLED]
EmbedVideo
ExternalData
Flow
Gadgets [BUNDLED]
HitCounters
ImageMap [BUNDLED]
InputBox [BUNDLED]
Interwiki [BUNDLED]
Linter [BUNDLED]
LoginNotify [BUNDLED]
MassEditRegex
Math [BUNDLED]
Matomo[d]
MobileFrontend
MultimediaViewer [BUNDLED]
Nuke [BUNDLED]
OATHAuth [BUNDLED]
OpenGraphMeta
PageImages [BUNDLED]
ParserFunctions [BUNDLED]
PdfHandler [BUNDLED]
Poem [BUNDLED]
Popups
Renameuser
ReplaceText [BUNDLED]
SandboxLink
Scribunto [BUNDLED]
SecureLinkFixer [BUNDLED]
SpamBlacklist [BUNDLED]
SyntaxHighlight_GeSHi [BUNDLED]
TemplateData [BUNDLED]
TemplateStyles
TextExtracts [BUNDLED]
Thanks [BUNDLED]
TimedMediaHandler
TitleBlacklist [BUNDLED]
VisualEditor [BUNDLED]
Wikibase
WikiEditor [BUNDLED]
WikiSEO

Once they are all installed, go to maintenance/ and run

php update.php --wiki de --quick
php update.php --wiki en --quick
php update.php --wiki es --quick
php update.php --wiki fr --quick
php update.php --wiki pt --quick
php update.php --wiki ru --quick
php update.php --wiki zh --quick

Notes

  1. Where LocalSettings.php is located
  2. Where all uploads are stored
  3. Where all multi-language logos are stored
  4. Matomo as of 2023 requires manual intervention