Mediawiki 1.35 Migration

From BITPlan Wiki
Jump to navigation Jump to search

view Mediawiki 1.35 Migration as slides

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

title
BITPlan
WolfgangFahl.png

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

MediaWikiLogo.png

⌘⌘ Why should i migrate?

Bigstockphoto Pray 1018025.jpg
  • 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?

Bigstock-Ruler-6212739.jpg
  • 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 Ubuntu logo.svg e.g. Ubuntu 20.04
lsb_release -a
Apache Apache Server Apache HTTP server logo (2019-present).svg e.g. 2.4
 /usr/sbin/apache2 -v
mariaDB Mariadb-seal-browntext.svg e.g. 15.1 / 10.3.25
mysql --version
PHP PHP-logo.svg > 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

Computer-kitten.jpg

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

Extensionnameurlpurposesince
Admin LinksAdmin Linkshttps://www.mediawiki.org/wiki/Extension:Admin LinksAdmin 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
DiagramsDiagramshttps://www.mediawiki.org/wiki/Extension:DiagramsReplaces deprecated

https://www.mediawiki.org/wiki/Extension:GraphViz and https://www.mediawiki.org/wiki/Extension:PlantUML

extensions
12 December 2019
Header TabsHeader Tabshttps://www.mediawiki.org/wiki/Extension:Header TabsThe Header Tabs extension transforms top-level MediaWiki headers into tabs using the jQuery UI JavaScript library.20 March 2008
HitCountersHitCountershttps://www.mediawiki.org/wiki/Extension:HitCountersHitCounters displays the view count in the page footer
and the most viewed pages on a special page called Special:PopularPages.
24 October 2014
ImageLinkImageLinkhttps://github.com/BITPlan/ImageLinkDisplay Image and Link20 March 2008
MagicNoCacheMagicNoCachehttps://www.mediawiki.org/wiki/Extension:MagicNoCacheThe 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 frequently1 January 2012
MapsMapshttps://www.mediawiki.org/wiki/Extension:Mapsdisplays maps2009
MermaidMermaidhttps://github.com/SemanticMediaWiki/MermaidThis 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
MsUploadMsUploadhttps://www.mediawiki.org/wiki/Extension:MsUploadThe MsUpload extension allows users to upload multiple files by drag & drop in the standard MediaWiki edit page.17 April 2013
NetworkNetworkhttps://www.mediawiki.org/wiki/Extension:NetworkGraphical display of page connections5 June 2020
PDFEmbedPDFEmbedhttps://github.com/WolfgangFahl/PDFEmbedDisplay PDF content inline
Page FormsPage Formshttps://www.mediawiki.org/wiki/Extension:Page Formsallows users to add, edit and query data using forms.7 September 2016
ParserFunctionsParserFunctionshttps://www.mediawiki.org/wiki/Extension:ParserFunctionsThe ParserFunctions extension enhances the wikitext parser with helpful functions, mostly related to logic and string-handling.
PiwoPiwohttps://www.mediawiki.org/wiki/Extension:PiwoCompiles and executes Python code stored in wiki pages.4 January 2018
Quiz-ExtensionQuizhttps://www.mediawiki.org/wiki/Extension:QuizQuiz-Sets for Training Wikis24 March 2007
Reveal-SlidesReveal-Slideshttps://github.com/PascalNoisette/mediawiki-extensions-SlidesSlideshow presentation from Wikimarkup using reveal.js2021
S5SlideShowS5SlideShowhttps://www.mediawiki.org/wiki/Extension:S5SlideShowSlideshow presentation from Wikimarkup2009
Semantic CiteSemantic Citehttps://www.mediawiki.org/wiki/Extension:Semantic CiteBibliographic References2015
Semantic MediaWikiSemantic Mediawikihttps://www.semantic-mediawiki.org/wiki/Semantic MediaWikiMediawiki with Semantic Annotation in Subject Predicate Object(Triple) style2005
Semantic WikibaseSemantic Wikibasehttps://www.mediawiki.org/wiki/Extension:Semantic Wikibase
SimpleMathJaxSimpleMathJaxhttps://www.mediawiki.org/wiki/Extension:SimpleMathJaxThe 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
SparqlResultFormatSparqlResultFormathttps://www.mediawiki.org/wiki/Extension:SparqlResultFormatAllows to render SPARQL query results7 August 2019
SyntaxHighlightingSyntaxHighlighthttps://www.mediawiki.org/wiki/Extension:SyntaxHighlightsyntax highlighting of diverse languages3 April 2007
UserFunctionsUserFunctionshttps://www.mediawiki.org/wiki/Extension:UserFunctionsThe UserFunctions extension provides a set of dynamic parser functions that trigger on the current user18 December 2011
VariablesVariableshttps://www.mediawiki.org/wiki/Extension:VariablesThe 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 clientWikibase Clienthttps://www.mediawiki.org/wiki/Extension:Wikibase Client
YouTubeYouTubehttps://www.mediawiki.org/wiki/Extension:YouTubeEmbed youtube videos26 October 2010

⌘⌘ Try and error

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

⌘⌘ Debug

Icon Debug 256x256.png

⌘⌘ Wiki Family

Icon people.svg

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

Clipboard20201125092135.png

⌘⌘ DNS entry

Clipboard20201125092527.png

ping partner.q.bitplan.com
PING q.bitplan.com (91.250.86.204) 56(84) bytes of data.
64 bytes from q.bitplan.com (91.250.86.204): icmp_seq=1 ttl=64 time=0.019 ms

⌘⌘ rsync images and settings

Clipboard20201125092143.png

⌘⌘ automatic git control

Clipboard20201125093912.png

⌘⌘ SQL database transfer

Clipboard20201125094532.png

⌘⌘ maintainance/update.php

Clipboard20201125094538.png

⌘⌘ Apache enable site / restart

Clipboard20201125095140.png

⌘⌘ Family index.php

http://q.bitplan.com Clipboard20201125095324.png

⌘⌘ Test Site

Clipboard20201125100337.png

⌘⌘ Questions/Discussion

Bitplanpartner.png