ProleWiki:Maintenance/Updating MediaWiki

From ProleWiki, the proletarian encyclopedia

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