Mediawiki 1.35 Migration

<slideshow style="bitplan" headingmark="⌘⌘" incmark="…" scaled="true" font="Arial" >

title

Mediawiki 1.35 LTS migration

author

Wolfgang Fahl info@bitplan.com

footer

Tutorial

subfooter

SMW Con Fall 2020

</slideshow>

⌘⌘ Agenda

• Why should i migrate / what is the effort / is it reversible?
• Prerequisites/Backup/Trial environment/Installation
• Extensions / Composer Based / List of Extensions
• Try and Error / Debug
• Wiki Family / Site Transfer automation
• Questions / Discussion

⌘⌘ MediaWiki 1.35 LTS

• https://www.mediawiki.org/wiki/MediaWiki_1.35
• Long Term Support LTS Version
• End of Life: September 2023.

⌘⌘ Why should i migrate?

• 1.31 LTS went end-of-life in June 2021.
• 1.27 LTS went end-of-life in June 2019.
• its an opportunity to clean and fix things
• Avoid the "Just upgrade!" shame

⌘⌘ What is the effort?

• It Depends ...
• BITPlan and
  Hello World
  report multi-week efforts ...

⌘⌘ Is the migration reversible?

• No its all or nothing!
• really?
• Really there is no proper incremental way
• You'll not like to try so better assume "No!"

⌘⌘ Prerequisites

LAMP Stack ..

Linux		e.g. Ubuntu 20.04	lsb_release -a
Apache Apache Server		e.g. 2.4	/usr/sbin/apache2 -v
mariaDB		e.g. 15.1 / 10.3.25	mysql --version
PHP		> 7.3.19	php --version

⌘⌘ Backup

1. mysqldump (full)

   /usr/bin/mysqldump $l_login_path --quick --routines $createopt --skip-add-locks --complete-insert --opt "$db" > $today/$dbfile
   

2. rsync of images directory

   rsync -avz  --no-perms --omit-dir-times $srcServer:$l_path/* $l_path
   

⌘⌘ Trial environment

Kids
don't do
this in your
production environment!

⌘⌘ Installation

wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.0.tar.gz
wf@q:/var/www/mediawiki$ sudo tar xvfz /usr/local/src/mediawiki-1.35.0.tar.gz

⌘⌘ Composer based

{
  "require": {
    "mediawiki/semantic-media-wiki": "~3.2.0",
    "mediawiki/semantic-cite": "~2.1.1",
    "mediawiki/semantic-result-formats": "~3.2.0",
    "mediawiki/page-forms": "^4.9.5",
    "mediawiki/maps": "~7.0"
  }
}

sudo chmod -R  g+w vendor extensions
composer update -vvv --no-dev
wfLoadExtension( 'Maps' );

⌘⌘ List of Extensions

Extension	name	url	purpose	since
Admin Links	Admin Links	https://www.mediawiki.org/wiki/Extension:Admin Links	Admin Links is an extension to MediaWiki that defines a special page, "Special:AdminLinks", that holds links meant to be helpful for wiki administrators; it is meant to serve as a "control panel" for the functions an administrator would typically perform in a wiki. All users can view this page; however, for those with the 'adminlinks' permission (sysops/administrators, by default), a link to the page also shows up in their "Personal URLs", between "Talk" and "Preferences".	13 May 2009
Diagrams	Diagrams	https://www.mediawiki.org/wiki/Extension:Diagrams	Replaces deprecated https://www.mediawiki.org/wiki/Extension:GraphViz and https://www.mediawiki.org/wiki/Extension:PlantUML extensions	12 December 2019
Header Tabs	Header Tabs	https://www.mediawiki.org/wiki/Extension:Header Tabs	The Header Tabs extension transforms top-level MediaWiki headers into tabs using the jQuery UI JavaScript library.	20 March 2008
HitCounters	HitCounters	https://www.mediawiki.org/wiki/Extension:HitCounters	HitCounters displays the view count in the page footer and the most viewed pages on a special page called Special:PopularPages.	24 October 2014
ImageLink	ImageLink	https://github.com/BITPlan/ImageLink	Display Image and Link	20 March 2008
MagicNoCache	MagicNoCache	https://www.mediawiki.org/wiki/Extension:MagicNoCache	The MagicNoCache extension creates a new magic word '"`UNIQ--nowiki-00000C16-QINU`"' and disables the cache for any page in which it finds it. Thus it makes sure that specific pages never get cached as they get updated extremely frequently	1 January 2012
Maps	Maps	https://www.mediawiki.org/wiki/Extension:Maps	displays maps	2009
Mermaid	Mermaid	https://github.com/SemanticMediaWiki/Mermaid	This extension provides the #mermaid parser function to support the generation of diagrams and flowcharts with the help of the mermaid script language.	30 December 2017
MsUpload	MsUpload	https://www.mediawiki.org/wiki/Extension:MsUpload	The MsUpload extension allows users to upload multiple files by drag & drop in the standard MediaWiki edit page.	17 April 2013
Network	Network	https://www.mediawiki.org/wiki/Extension:Network	Graphical display of page connections	5 June 2020
PDFEmbed	PDFEmbed	https://github.com/WolfgangFahl/PDFEmbed	Display PDF content inline
Page Forms	Page Forms	https://www.mediawiki.org/wiki/Extension:Page Forms	allows users to add, edit and query data using forms.	7 September 2016
ParserFunctions	ParserFunctions	https://www.mediawiki.org/wiki/Extension:ParserFunctions	The ParserFunctions extension enhances the wikitext parser with helpful functions, mostly related to logic and string-handling.
Piwo	Piwo	https://www.mediawiki.org/wiki/Extension:Piwo	Compiles and executes Python code stored in wiki pages.	4 January 2018
Quiz-Extension	Quiz	https://www.mediawiki.org/wiki/Extension:Quiz	Quiz-Sets for Training Wikis	24 March 2007
Reveal-Slides	Reveal-Slides	https://github.com/PascalNoisette/mediawiki-extensions-Slides	Slideshow presentation from Wikimarkup using reveal.js	2021
S5SlideShow	S5SlideShow	https://www.mediawiki.org/wiki/Extension:S5SlideShow	Slideshow presentation from Wikimarkup	2009
Semantic Cite	Semantic Cite	https://www.mediawiki.org/wiki/Extension:Semantic Cite	Bibliographic References	2015
Semantic MediaWiki	Semantic Mediawiki	https://www.semantic-mediawiki.org/wiki/Semantic MediaWiki	Mediawiki with Semantic Annotation in Subject Predicate Object(Triple) style	2005
Semantic Wikibase	Semantic Wikibase	https://www.mediawiki.org/wiki/Extension:Semantic Wikibase
SimpleMathJax	SimpleMathJax	https://www.mediawiki.org/wiki/Extension:SimpleMathJax	The SimpleMathJax extension enables MathJax, a JavaScript library, for typesetting TeX formula in MediaWiki inside math environments. - Workaround if extension Math does not work	10 September 2014
SparqlResultFormat	SparqlResultFormat	https://www.mediawiki.org/wiki/Extension:SparqlResultFormat	Allows to render SPARQL query results	7 August 2019
SyntaxHighlighting	SyntaxHighlight	https://www.mediawiki.org/wiki/Extension:SyntaxHighlight	syntax highlighting of diverse languages	3 April 2007
UserFunctions	UserFunctions	https://www.mediawiki.org/wiki/Extension:UserFunctions	The UserFunctions extension provides a set of dynamic parser functions that trigger on the current user	18 December 2011
Variables	Variables	https://www.mediawiki.org/wiki/Extension:Variables	The Variables extension allows you to define a variable on a page, use it later in that same page or included templates ...	13 November 2011
Wikibase client	Wikibase Client	https://www.mediawiki.org/wiki/Extension:Wikibase Client
YouTube	YouTube	https://www.mediawiki.org/wiki/Extension:YouTube	Embed youtube videos	26 October 2010

⌘⌘ Try and error

• start with an "empty" list of extensions
• activate extension by extension
• on error - fix or disable

⌘⌘ Debug

• Mediawiki Manual:How to debug
• PHP_Mediawiki_Eclipse_debugging

⌘⌘ Wiki Family

Wiki_Family

⌘⌘ Site Transfer automation

#  Apache configuration
tsite partner -s s.bitplan.com   -b -a
# Images, Localsettings and git
tsite partner -s s.bitplan.com   -b -g -cs
# Pages via Database
tsite partner -s s.bitplan.com   -b -g -db
# Update to new version
tsite partner -s s.bitplan.com   -w
# Enable apache
tsite partner -e

⌘⌘ Apache configuration

⌘⌘ DNS entry

⌘⌘ Questions/Discussion