Mediawiki 1.35 Migration

view Mediawiki 1.35 Migration as slides

<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

⌘⌘ Agenda[edit]

• 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[edit]

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

⌘⌘ Why should i migrate?[edit]

• 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?[edit]

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

⌘⌘ Is the migration reversible?[edit]

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

⌘⌘ Prerequisites[edit]

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[edit]

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[edit]

Kids
don't do
this in your
production environment!

⌘⌘ Installation[edit]

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[edit]

{
  "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[edit]

⌘⌘ Try and error[edit]

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

⌘⌘ Debug[edit]

• Mediawiki Manual:How to debug
• PHP_Mediawiki_Eclipse_debugging

⌘⌘ Wiki Family[edit]

Wiki_Family

⌘⌘ Site Transfer automation[edit]

#  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[edit]

⌘⌘ DNS entry[edit]

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[edit]

⌘⌘ automatic git control[edit]

⌘⌘ SQL database transfer[edit]

⌘⌘ maintainance/update.php[edit]

⌘⌘ Apache enable site / restart[edit]

⌘⌘ Family index.php[edit]

http://q.bitplan.com

⌘⌘ Test Site[edit]

• check version
• check content

⌘⌘ Questions/Discussion[edit]